通过

CheckTokenCapability 函数 (securitybaseapi.h)

  • 项目

CheckTokenCapability 函数检查给定令牌的功能。

语法

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

parameters

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