gss_process_context_token(3sec)

Synopsis

#include <dce/gssapi.h>

OM_uint32 gss_process_context_token (
OM_uint32 *minor_status,
gss_ctx_id_t *context_handle,
gss_buffer_t input_token_buffer)

Parameters

Input

context_handle
Specifies the context handle on which the security service processes the token.

input_token_buffer
Specifies an opaque pointer to the first byte of the token to be processed.

Output

minor_status
Returns a status code from the security mechanism.

Description
The gss_process_context_token( ) routine passes tokens generated by the gss_delete_security_context( ) routine to the security service.

Usually, tokens are associated with either the context establishment or with per-message security services. If the tokens are associated with the context establishment, they are passed to the gss_init_sec_context( ) or gss_accept_sec_context( ) routine. If the tokens are associated with the per-message security service, they are passed to the gss_verify( ) or gss_unseal( ) routine. Tokens generated by the gss_delete_security_context( ) routine are passed by the gss_process_context_token( ) routine to the security service for processing.

Errors

The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. The following status codes can be returned:

GSS_S_COMPLETE	The routine was completed successfully.
GSS_S_DEFECTIVE_TOKEN	Consistency checks performed on the input_token parameter failed.
GSS_S_FAILURE	The routine failed. See the minor_status parameter return value for more information.
GSS_S_NO_CONTEXT	The supplied context handle did not refer to a valid context.

Related Information
Functions: gss_delete_sec_context(3sec)