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 [僅限傳統型應用程式] |
| 標頭 |
|
| DLL |
|