NAME

gss_process_context_token — Passes a context to the security service

Synopsis

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. 

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_security_context(3sec).