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，則必須呼叫下列其中一個函式來遞減模擬令牌的參考計數：
- ObDereferenceObject，適用於 Windows 2000
- PsDereferenceImpersonationToken，適用於 Microsoft Windows XP 或更新版本
如需安全性和訪問控制的詳細資訊，請參閱 適用於驅動程序開發人員的 Windows 安全性模型 ，以及 Windows SDK 中有關這些主題的檔。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 |
| 目標平台 | Universal |
| 標頭 | ntifs.h (包括 FltKernel.h、Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI 合規性規則 | HwStorPortProhibitedDIS (storport) |