checkTokenCapability 函式 (securitybaseapi.h)

  • 發行項

CheckTokenCapability 函式會檢查指定權杖的功能。

語法

BOOL CheckTokenCapability(
  [in, optional] HANDLE TokenHandle,
  [in]           PSID   CapabilitySidToCheck,
  [out]          PBOOL  HasCapability
);

參數

[in, optional] TokenHandle

存取權杖的控制碼。 控制碼必須具有權杖TOKEN_QUERY存取權。 權杖必須是 模擬權杖。

如果 TokenHandle 為 Null， CheckTokenCapability 會使用呼叫執行緒的模擬權杖。 如果執行緒未模擬，函式會複製執行緒 的主要權杖 ，以建立 模擬權杖。

[in] CapabilitySidToCheck

功能 SID 結構的指標。 CheckTokenCapability 函式會檢查此存取權杖的功能。

[out] HasCapability

接收檢查的結果。 如果存取權杖具有功能，則會傳回 TRUE，否則會傳回 FALSE。

傳回值

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

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

需求

   
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
目標平台 Windows
標頭 securitybaseapi.h (包含 Windows.h)
程式庫 Advapi32.lib
DLL Kernel32.dll