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)

另請參閱

ObDereferenceObject

PsDereferenceImpersonationToken

PsImpersonateClient

SECURITY_IMPERSONATION_LEVEL