gss_import_sec_context()--Import Security Context
Syntax
#include <krb5.h> krb5_error_code gss_import_sec_context ( OM_uint32 * minor_status, gss_buffer_t context_token, gss_ctx_id_t * context_handle)Service Program Name: QSYS/QKRBGSS
Default public authority: *USE
Threadsafe: Yes
The gss_import_sec_context() routine accepts a security context token created by the strong>gss_export_sec_context() routine and creates a GSS-API security context. Since the security context contains message sequencing information, it is usually not feasible to create multiple security contexts from a single context token.
The gss_delete_sec_context() routine should be called to delete the GSS-API security context when it is no longer needed. The security context 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.
- context_token (Input)
- The security context token created by the
gss_export_sec_context() routine.
- context_handle (Output)
- The context handle returned for the security context created from the
context token. The gss_delete_sec_context() routine should be
called to delete the security context 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 ]