gss_krb5_copy_ccache()--Copy Tickets From Associated GSS Credentials to Kerberos Protocol Credentials Cache
Syntax
#include <krb5.h> krb5_error_code gss_krb5_copy_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_copy_ccache() routine will copy the tickets from the Kerberos credentials cache associated with a GSS-API credential to a credentials cache provided by the caller. The supplied Kerberos credentials cache must have been initialized by krb5_cc_initialize() before calling gss_krb5_copy_ccache(). The GSS-API credential must have been created by specifying GSS_C_INITIATE or GSS_C_BOTH.
Parameters
- minor_status (Output)
- Status code returned from the security mechanism.
- cred_handle (Input)
- The GSS-API credential handle. This must be a GSS_C_INITIATE or GSS_C_BOTH credential.
- ccache (Input)
- The Kerberos credentials cache.
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 which 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-API credential.
Authorities
None.
Error Messages
Message ID | Error Message Text |
---|---|
CPE3418 E | Possible APAR condition or hardware failure. |
CPFA081 E | Unable to set return value or error code. |
API introduced: V5R2
[ Back to top | Security APIs | UNIX-Type APIs | APIs by category ]