ApplyControlToken (Windows Embedded CE 6.0)

1/6/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

See Also

Reference

Authentication Services Functions
InitializeSecurityContext
SecBuffer
SecBufferDesc