CheckTokenMembershipEx 函式 (securitybaseapi.h)

CheckTokenMembershipEx函式會判斷指定的 SID 是否在指定的權杖中啟用。

語法

BOOL CheckTokenMembershipEx(
  [in, optional] HANDLE TokenHandle,
  [in]           PSID   SidToCheck,
  [in]           DWORD  Flags,
  [out]          PBOOL  IsMember
);

參數

[in, optional] TokenHandle

存取權杖的控制碼。 如果存在，則會檢查此權杖是否有 SID。 如果沒有，則會使用目前的有效權杖。 這必須是模擬權杖。

[in] SidToCheck

SID 結構的指標。 函式會檢查權杖是否存在此 SID。

[in] Flags

影響函式行為的旗標。 目前唯一有效的旗標是CTMF_INCLUDE_APPCONTAINER，只要符合權杖的其他需求，應用程式容器就可以傳遞呼叫，例如指定的群組存在並啟用。

[out] IsMember

如果在權杖中啟用 SID，則為TRUE;否則為FALSE。

傳回值

如果函式成功，則會傳回 TRUE。

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

需求

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