NtCompareTokens 函数

NtCompareTokens 函数比较两个访问令牌,并确定它们是否等效于对 AccessCheck 函数的调用。

语法

NTSTATUS NTAPI NtCompareTokens(
  _In_  HANDLE   FirstTokenHandle,
  _In_  HANDLE   SecondTokenHandle,
  _Out_ PBOOLEAN Equal
);

parameters

FirstTokenHandle [in]

要比较的第一个访问令牌的句柄。 令牌必须打开才能 TOKEN_QUERY 访问。

SecondTokenHandle [in]

要比较的第二个访问令牌的句柄。 令牌必须打开才能 TOKEN_QUERY 访问。

等于 [out]

指向变量的指针,该变量接收一个值,该值指示 FirstTokenHandleSecondTokenHandle 参数表示的标记是否等效。

返回值

如果函数成功,该函数将返回STATUS_SUCCESS。

如果函数失败,它将返回 NTSTATUS 错误代码。

备注

如果满足以下所有条件,则两个访问控制令牌被视为等效令牌:

  • 其中一个令牌中存在的每个 安全标识符 (SID) 也存在于另一个令牌中。
  • 两个令牌或两个令牌均不受限制。
  • 如果两个令牌都受到限制,则一个令牌中限制的每个 SID 也会在其他令牌中受到限制。
  • 其中一个令牌中存在的每个特权也存在于另一个令牌中。

此函数没有关联的导入库或头文件;必须使用 LoadLibraryGetProcAddress 函数调用它。

要求

要求
最低受支持的客户端
Windows XP [仅限桌面应用]
最低受支持的服务器
Windows Server 2003 [仅限桌面应用]
标头
Ntseapi.h
DLL
Ntdll.dll