NAME
gss_process_context_token() — process a context to the security service
SYNOPSIS
#include <gssapi.h>
OM_uint32 gss_process_context_token (
OM_uint32 *minor_status,
const gss_ctx_id_t *context_handle,
const gss_buffer_t input_token_buffer)
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.
Input Parameters
- 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 Parameters
- minor_status
Returns a status code from the security mechanism.
STATUS CODES
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.
AUTHOR
gss_process_context_token()
was developed by Sun Microsystems, Inc.