CheckTokenMembershipEx 函数 (securitybaseapi.h)

CheckTokenMembershipEx 函数确定是否在指定的令牌中启用指定的 SID。

语法

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

parameters

[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)
Library	Advapi32.lib
DLL	Kernel32.dll