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 ]