NAME

gss_delete_sec_context — Deletes a security context

Synopsis

OM_uint32  gss_delete_sec_context(
OM_uint32 ∗minor_status,
gss_ctx_id_t ∗context_handle,
gss_buffer_t output_token_buffer);

Parameters

Input/Output

context_handle
Specifies the context handle for the context to delete.

Output

minor_status
Returns a status code from the security mechanism.

output_token_buffer
Returns a token to pass to the context acceptor.

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. 

Status Codes

The following describes a partial list of codes (messages) that might be returned.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all messages.  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.

Related Information

Functions: gss_accept_sec_context(3sec), gss_init_sec_context(3sec), gss_process_context_token(3sec).