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 ]