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)

See also

PsImpersonateClient

PsReferenceImpersonationToken