ApplyControlToken
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 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 |