HP-UX Reference (11i v2 07/12) - 3 Library Functions A-M (vol 6)

g
gss_delete_sec_context(3) gss_delete_sec_context(3)
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 associ-
ated local data structures.
When the context is deleted, the applications cannot use the context_handle parameter for additional secu-
rity 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 infor-
mation.
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.
SEE ALSO
gss_accept_sec_context(3), gss_init_sec_context(3), gss_process_context_token(3).
The manpages for DCE-GSSAPI are included with the DCE-CoreTools product. To see those manpages add
/opt/dce/share/man
to MANPATH.
HP-UX 11i Version 2: December 2007 Update 1 Hewlett-Packard Company 583