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