ImpersonateSelf
The ImpersonateSelf
function obtains an access token that impersonates the security context of the
calling process. The token is assigned to the calling thread.
BOOL ImpersonateSelf(
|
SECURITY_IMPERSONATION_LEVEL ImpersonationLevel |
// impersonation
level |
|
); |
|
Parameters
ImpersonationLevel
Specifies a SECURITY_IMPERSONATION_LEVEL enumerated type that
supplies the impersonation level of the new token.
Return Values
If the
function succeeds, the return value is nonzero.
If the
function fails, the return value is zero. To get extended error information,
call GetLastError.
Remarks
The ImpersonateSelf
function is used for tasks, such as enabling a privilege for a single thread
rather than for the entire process or for changing the default discretionary
access-control list for a single thread.
The server
can call the RevertToSelf function when the impersonation is complete.
See Also