SpGetContextToken function
Obtains the token to impersonate. The SpGetContextToken function is used by the SSPI ImpersonateSecurityContext function to obtain the token to impersonate.
Syntax
NTSTATUS SpGetContextToken( _In_ LSA_SEC_HANDLE ContextHandle, _Out_ PHANDLE ImpersonationToken );
Parameters
- ContextHandle [in]
-
A handle to the context to impersonate.
- ImpersonationToken [out]
-
Pointer that receives a handle to the token for the specified context. Return the handle to the token without first duplicating the handle or the token.
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 a common reason for failure and the error code that the function should return.
| Return code | Description |
|---|---|
|
The handle is not valid. |
Remarks
SSP/APs must implement the SpGetContextToken function; however, the actual name given to the implementation is up to the developer.
A pointer to the SpGetContextToken function is available in the SECPKG_USER_FUNCTION_TABLE structure received from the SpUserModeInitialize function.
Requirements
|
Minimum supported client |
Windows XP [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2003 [desktop apps only] |
|
Header |
|
See also