gss_import_cred()--Import GSS Credential
Syntax
#include <krb5.h> krb5_error_code gss_import_cred ( OM_uint32 * minor_status, gss_buffer_t cred_token, gss_ctx_id_t * cred_handle)Service Program Name: QSYS/QKRBGSS
Default public authority: *USE
Threadsafe: Yes
The gss_import_cred() routine accepts a credential token created by the gss_export_cred() routine and creates a GSS-API credential.
The gss_release_cred() routine should be called to release the GSS-API credential when it is no longer needed. The credential token created by one implementation of GSS-API cannot be used with a different implementation of GSS-API.
Parameters
- minor_status (Output)
- Status code returned from the security mechanism.
- cred_token (Input)
- The credential token created by the gss_export_cred()
routine.
- cred_handle (Output)
- The credential handle returned for the GSS-API credential created from the
credential token. The gss_release_cred() routine should be
called to release the credential when it is no longer needed.
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_DEFECTIVE_TOKEN
- The supplied credential token is not valid.
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 ]