SpApplyControlToken function
Applies a control token to a security context. This function is not currently called by the Local Security Authority (LSA).
Syntax
NTSTATUS SpApplyControlToken( _In_ LSA_SEC_HANDLE ContextHandle, _In_ PSecBufferDesc ControlToken );
Parameters
- ContextHandle [in]
-
A handle to the security context to be modified based on the ControlToken parameter.
- ControlToken [in]
-
Pointer to a SecBufferDesc structure containing the token to apply to the context.
Return value
If the function succeeds, return STATUS_SUCCESS.
If the function fails, return an NTSTATUS code that indicates the reason it failed. The following lists common reasons for failure and the error codes that the function should return.
| Return code | Description |
|---|---|
|
The token is not valid. |
|
The handle is not valid. |
Remarks
SSP/APs must implement the SpApplyControlToken function; however, the actual name given to the implementation is up to the developer.
A pointer to the SpApplyControlToken function is available in the SECPKG_FUNCTION_TABLE structure received from the SpLsaModeInitialize function.
Requirements
|
Minimum supported client |
Windows XP [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2003 [desktop apps only] |
|
Header |
|
See also