Edit

Share via

PsDereferenceImpersonationToken function (ntifs.h)

  • Article

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)

See also

PsImpersonateClient

PsReferenceImpersonationToken