ApplyControlToken (Compact 2013)

  • Article

3/28/2014

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

See Also

Reference

Authentication Services Functions
InitializeSecurityContext
SecBuffer
SecBufferDesc