NAME
gss_delete_sec_context() — delete a security context
SYNOPSIS
#include<gssapi.h>
OM_uint32 gss_delete_sec_context (
OM_uint32 *minor_status,
gss_ctx_id_t *context_handle,
gss_buffer_t output_token_buffer)
DESCRIPTION
The
gss_delete_sec_context()
routine deletes a security context.
It also deletes the local data structures associated with the security
context. When it deletes the context, the routine can generate a
token. The application passes the token to the context acceptor.
The context acceptor then passes the token to the
gss_process_context_token()
routine, telling it to delete the context
and all associated local data structures.
When the context is deleted, the applications cannot use the
context_handle
parameter for additional security services.
Input Parameters
- context_handle
Specifies the context handle for the context to delete.
Output Parameters
- minor_status
Returns a status code from the security mechanism.
- output_token_buffer
Returns a token to pass to the context acceptor.
STATUS CODES
The following status codes can be returned:
- GSS_S_COMPLETE
The routine was completed successfully.
- 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_delete_sec_context()
was developed by Sun Microsystems, Inc.