Share via


ApplyControlToken

A version of this page is also available for

Windows Embedded CE 6.0 R3

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 InitializeSecurityContext or 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 CtxtHandle structure identifying the handle to the context to which the token is applied. For information on CtxtHandle, see SSPI Handles.
  • pInput
    [in] Pointer to a SecBufferDesc structure with a pointer to a SecBuffer structure 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

Reference

InitializeSecurityContext
SecBuffer
SecBufferDesc