PreviousNext

gss_delete_sec_context(3sec)

Deletes a security context

Synopsis

#include <dce/gssapi.h>

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)