PsDereferenceImpersonationToken function

The PsDereferenceImpersonationToken routine decrements the reference count of an impersonation token.

Syntax

void PsDereferenceImpersonationToken(
  PACCESS_TOKEN ImpersonationToken
);

Parameters

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 the documentation on these topics in the Microsoft Windows SDK.

Requirements

   
Target Platform Universal
Header ntifs.h (include Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

See Also

PsImpersonateClient

PsReferenceImpersonationToken