Deletes an identity token.
#include <client.h> void delete_identity ( int identity);
(IN) Specifies the identity to delete.
Identity tokens have use counts which are incremented each time a token is created for the same user. When the delete_identity function is called, it decrements the use count. If the use count decrements to 0, the token is deleted, which invalidates any path contexts that contain it.
Before deleting an identity, you should first delete any path contexts that use the identity.
The delete_identity function does not return an error code when an error occurs, but it does set errno to one of the following: