PsDereferenceImpersonationToken function (ntifs.h)
The PsDereferenceImpersonationToken routine decrements the reference count of an impersonation token.
Syntax
void PsDereferenceImpersonationToken(
[in] PACCESS_TOKEN ImpersonationToken
);
Parameters
[in] ImpersonationToken
Pointer to the impersonation token whose reference count is to be decremented. If this is a NULL pointer, PsDereferenceImpersonationToken does nothing.
Return value
None
Remarks
If the token's reference count reaches zero, the token is deleted.
For more information about security and access control, see Windows security model for driver developers and the documentation on these topics in the Windows SDK.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Universal |
| Header | ntifs.h (include Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |
| DDI compliance rules | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |