Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function provides a way to apply a control token to a security context. A token can be received when the security context is being established by means of InitializeSecurityContextor with a per-message security service, such as verify or unseal.

This function also allows additional or replacement tokens to be applied to a context.

Syntax 

SECURITY_STATUS SEC_ENTRY ApplyControlToken( 
  PCtxtHandle
 phContext,
  PSecBufferDesc
 pInput 
);

Parameters

phContext

[in] Pointer to a CtxtHandlestructure identifying the handle to the context to which the token is applied. For information on CtxtHandle, see SSPI Handles.

pInput

[in] Pointer to a SecBufferDescstructure with a pointer to a SecBufferstructure that contains the input token to apply to the context.

Return Value

Returns SEC_E_OK to indicate success. A nonzero error value indicates failure.

Remarks

This function can modify the context based on the control token.

Requirements

Header security.h, sspi.h
Library secur32.lib
Windows Embedded CE Windows CE 2.10 and later
Windows Mobile Smartphone 2002 and later

See Also