gss_release_cred(3sec)

Synopsis

#include <dce/gssapi.h>

OM_uint32 gss_release_cred (
OM_uint32 *minor_status,
gss_cred_id_t *cred_handle)

Parameters

Input

cred_handle
Specifies the buffer containing the opaque credential handle. This information is optional. To release the default credential, specify GSS_C_NO_CREDENTIAL.

Output

minor_status
Returns a status code from the security mechanism.

Description
The gss_release_cred( ) routine informs the GSSAPI that a credential is no longer required and marks it for deletion.

Errors

The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages.

GSS_S_COMPLETE	The routine was completed successfully.
GSS_S_FAILURE	The routine failed. Check the minor_status parameter for details.
GSS_S_NO_CRED	The credentials could not be accessed.