Share via


ApplyControlToken

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.

SECURITY_STATUS ApplyControlToken( 
PCtxtHandle phContext,
PSecBufferDesc pInput );

Parameters

  • phContext
    [in] Pointer to the handle to the context to which the token is applied.
  • 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 Values

SEC_E_OK indicates success. A nonzero error value indicates failure.

Remarks

The ApplyControlToken function may modify the context based on this token.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 2.10 and later Sspi.h Security.h Schannel.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

InitializeSecurityContext, SecBuffer, SecBufferDesc

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.