gss_krb5_get_ccache()--Get Kerberos Protocol Credentials Cache Associated with Specified GSS Credential
Syntax
#include <gssapi.h> OM_uint32 gss_krb5_get_ccache ( OM_uint32 * minor_status, gss_cred_id_t cred_handle, krb5_ccache * ccache);Service Program Name: QSYS/QKRBGSS
Default public authority: *USE
Threadsafe: Yes
The gss_krb5_get_ccache() function returns the returns the handle for the Kerberos credentials cache associated with a GSS credential. The application must not close or destroy this credentials cache. The returned handle is longer be valid once the GSS credential has been released.
Parameters
- minor_status (Output)
- A status code from the security mechanism.
- cred_handle (Input)
- The handle for the GSS credential.
- ccache (Output)
- The handle for the credentials cache. A NULL value is returned if there is no credentials cache associated with the GSS credential.
Return Value
The return value is one of the following status codes:
- GSS_S_COMPLETE
- The routine completed successfully.
- 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 credential handle does not refer to a valid GSS 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 ]