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.
At a Glance
Header file: | Sspi.h |
Windows CE versions: | 2.10 and later |
Syntax
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.
See Also