gss_import_sec_context()--Import Security Context

 #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)

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

[ Back to top | Security APIs | UNIX-Type APIs | APIs by category ]