NtCompareTokens 函式

NtCompareTokens函式會比較兩個存取權杖，並判斷它們是否與AccessCheck函式的呼叫相等。

語法

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

參數

FirstTokenHandle [in]

要比較之第一個存取權杖的控制碼。 權杖必須開啟才能 TOKEN_QUERY 存取。

SecondTokenHandle [in]

要比較之第二個存取權杖的控制碼。 權杖必須開啟才能 TOKEN_QUERY 存取。

等於 [out]

接收值的變數指標，指出 FirstTokenHandle 和 SecondTokenHandle 參數所代表的標記是否相等。

傳回值

如果函式成功，函式會傳回STATUS_SUCCESS。

如果函式失敗，它會傳回 NTSTATUS 錯誤碼。

備註

如果下列所有條件都成立，則會將兩個存取控制權杖視為相等：

• 每個 安全性識別碼 (存在於任一權杖中的 SID) 也會出現在另一個權杖中。
• 兩個權杖都不受限制。
• 如果這兩個權杖都受到限制，則一個權杖中限制的每個 SID 也會在其他權杖中受到限制。
• 任一權杖中的每個許可權也會出現在另一個權杖中。

此函式沒有相關聯的匯入程式庫或標頭檔;您必須使用 LoadLibrary 和 GetProcAddress 函式呼叫它。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
標頭	Ntseapi.h
DLL	Ntdll.dll