IsTokenRestricted 函数 (securitybaseapi.h)

  • 项目

IsTokenRestricted 函数指示令牌是否包含受限制的安全标识符列表， (SID) 。

语法

BOOL IsTokenRestricted(
  [in] HANDLE TokenHandle
);

参数

[in] TokenHandle

要测试 的访问令牌 的句柄。

返回值

如果令牌包含限制 SID 的列表，则返回值为非零值。

如果令牌不包含限制 SID 的列表，则返回值为零。

如果发生错误，则返回值为 0。 要获得更多的错误信息，请调用 GetLastError。

注解

CreateRestrictedToken 函数可以通过禁用 SID、删除特权和指定限制 SID 的列表来限制令牌。 IsTokenRestricted 函数仅检查限制 SID 的列表。 如果令牌没有任何限制 SID，IsTokenRestricted 将返回 FALSE，即使令牌是通过调用 CreateRestrictedToken 创建的。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 securitybaseapi.h (包括 Windows.h)
Library Advapi32.lib
DLL Advapi32.dll

另请参阅

访问控制概述

基本访问控制函数

CreateRestrictedToken