Function

gss_process_context_token

Processes a token from a peer asynchronously.

Declaration

OM_uint32 gss_process_context_token(OM_uint32 *minor_status, gss_ctx_id_t context_handle, gss_buffer_t token_buffer);

Parameters

minor_status

A pointer to the secondary status result that provides additional information in case of failure.

context_handle

The context that should handle the token.

token_buffer

The token to process.

Return Value

A status code set to GSS_S_COMPLETE on success. See Function Status for a description of other status outputs.

Discussion

Normally, contexts exchange tokens during the initialization process, using gss_init_sec_context and in the initiator and gss_accept_sec_context in the acceptor. Occasionally, a mechanism needs to send a token asynchronously, for example after a call to the gss_delete_sec_context function when you supply an output token buffer. The gss_process_context_token function provides a means to supply a token received from a peer to the context unexpectedly.

See Also

Creation and Deletion

gss_init_sec_context

Initiates a security context with a peer.

gss_accept_sec_context

Accepts a security context initiated by a peer.

gss_delete_sec_context

Deletes a security context.

gss_release_cred

Releases the memory of a credential.

gss_set_sec_context_option

Sets an option on a context.