gss_release_cred()--Release Storage Associated with GSS Credential

Syntax

 #include <gssapi.h>

 OM_uint32 gss_release_cred(
     OM_uint32 *    minor_status,
     gss_cred_id_t *    cred_handle);

  Service Program Name: QSYS/QKRBGSS

  Default public authority: *USE

  Threadsafe: Yes

The gss_release_cred() function releases the local data structures associated with a GSS credential. If gss_c_no_credential is specified for the cred_handle parameter, no credential is released and gss_s_complete is returned for the major status return value.

Parameters

minor_status (Output): A status code from the security mechanism.
cred_handle (Input/Output): The credential to be released. Upon successful completion, the cred_handle value is set to GSS_C_NO_CREDENTIAL. If the cred_handle value is GSS_C_NO_CREDENTIAL, the major status return value is GSS_S_COMPLETE and nothing is released.

Return Value

The return value is one of the following status codes:

GSS_S_COMPLETE: The routine completed successfully.
GSS_S_DEFECTIVE_CREDENTIAL: Consistency checks performed on the credential structure failed.
GSS_S_FAILURE: The routine failed for reasons that are not defined at the GSS level. The minor_status return parameter contains a mechanism-dependent error code describing the reason for the failure.
GSS_S_NO_CRED: The cred_handle parameter does not refer to a valid credential.

Authorities

Object Referred to	Data Authority Required
Each directory in the path name preceding the configuration file	*X
Configuration file	*R

Error Messages

Message ID	Error Message Text
CPE3418 E	Possible APAR condition or hardware failure.

API introduced: V5R1

[ Back to top | Security APIs | UNIX-Type APIs | APIs by category ]