gss_export_sec_context()--Export Security Context

 #include <krb5.h>

 krb5_error_code gss_export_sec_context (
    OM_uint32 *                         minor_status,
    gss_ctx_id_t *                      context_handle,
    gss_buffer_t                        context_token)

The gss_export_sec_context() routine creates a context token for a GSS-API security context. This context token can then be given to another process on the same system. This second process calls gss_import_sec_context() to create a GSS-API security context from the context token. Upon successful completion of gss_export_sec_context(), the security context is no longer available for use by the current process. 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_handle  (Input/Output)

The context handle of the GSS-API security context to be used to create the security context token. The context handle will be set to GSS_C_NO_CONTEXT upon successful completion.

context_token  (Output)

The security context token returned. The storage for the token should be released when it is no longer needed by calling the gss_release_buffer() routine.

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_CONTEXT

The supplied context handle does not refer to a valid context.

GSS_S_CONTEXT_EXPIRED

The supplied context is no longer valid.

GSS_S_UNAVAILABLE

Security context cannot be exported.

Authorities

None.

Error Messages

[ Back to top | Security APIs | APIs by category ]