PsReferenceImpersonationToken 函式 （ntifs.h）
PsReferenceImpersonationToken 例程會遞增指定線程之模擬令牌的參考計數。
語法
PACCESS_TOKEN PsReferenceImpersonationToken(
[in, out] PETHREAD Thread,
[out] PBOOLEAN CopyOnOpen,
[out] PBOOLEAN EffectiveOnly,
[out] PSECURITY_IMPERSONATION_LEVEL ImpersonationLevel
);
參數
[in, out] Thread
模擬令牌參考計數要遞增的線程位址。
[out] CopyOnOpen
呼叫端配置的布爾變數指標。 傳回時，如果無法直接開啟令牌，此參數就會收到TRUE。 在此情況下，令牌必須重複，而且必須改用重複的令牌。 如果可以直接開啟令牌，此參數會收到 FALSE。
[out] EffectiveOnly
呼叫端配置的布爾變數指標。 如果允許線程啟用用戶端安全性內容中目前停用的群組和許可權，此參數就會收到 FALSE，否則為 TRUE。
[out] ImpersonationLevel
呼叫端配置的SECURITY_IMPERSONATION_LEVEL變數指標。 傳回時，此參數會收到值，指定允許線程存取令牌的模擬層級。
傳回值
PsReferenceImpersonationToken 會傳回指定線程模擬令牌的指標。 如果線程目前未模擬用戶端，則會傳回 NULL 指標。
言論
如果線程目前模擬用戶端，PsReferenceImpersonationToken 遞增模擬令牌的參考計數，並傳回令牌的指標。 如果傳回的指標不是NULL，則模擬令牌的參考計數必須藉由呼叫下列其中一個函式來遞減：
- 適用於 Windows 2000 的 ObDereferenceObject
- Microsoft Windows XP 或更新版本的 PsDereferenceImpersonationToken
如需安全性和訪問控制的詳細資訊，請參閱 適用於驅動程式開發人員的 Windows 安全性模型，以及 Windows SDK 中這些主題的檔。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 |
| 目標平臺 | 普遍 |
| 標頭 | ntifs.h （include FltKernel.h， Ntifs.h） |
| 連結庫 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI 合規性規則 | HwStorPortProhibitedDIs（storport） |