impersonateSelf 函式 (securitybaseapi.h)

ImpersonateSelf 函式會取得存取令牌，以模擬呼叫進程的安全性內容。令牌會指派給呼叫線程。

語法

BOOL ImpersonateSelf(
  [in] SECURITY_IMPERSONATION_LEVEL ImpersonationLevel
);

[in] ImpersonationLevel

指定提供新令牌模擬層級的SECURITY_IMPERSONATION_LEVEL 列舉型別。

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

ImpersonateSelf 函式用於啟用單一線程的許可權，而不是針對整個進程啟用許可權，或變更單一線程的預設任意訪問控制清單 (DACL) 。

當模擬完成時，伺服器可以呼叫 RevertToSelf 函式。

若要讓此函式成功，保護進程令牌的 DACL 必須授與TOKEN_DUPLICATE本身的許可權。

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	securitybaseapi.h (包括 Windows.h)
程式庫	Advapi32.lib
Dll	Advapi32.dll