Fungsi NtCompareTokens

Fungsi NtCompareTokens membandingkan dua token akses dan menentukan apakah token tersebut setara sehubungan dengan panggilan ke fungsi AccessCheck .

Sintaks

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

Parameter

FirstTokenHandle [in]

Handel ke token akses pertama untuk dibandingkan. Token harus terbuka untuk akses TOKEN_QUERY .

SecondTokenHandle [in]

Handel ke token akses kedua untuk dibandingkan. Token harus terbuka untuk akses TOKEN_QUERY .

Sama dengan [keluar]

Penunjuk ke variabel yang menerima nilai yang menunjukkan apakah token yang diwakili oleh parameter FirstTokenHandle dan SecondTokenHandle setara.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan STATUS_SUCCESS.

Jika fungsi gagal, fungsi mengembalikan kode kesalahan NTSTATUS .

Keterangan

Dua token kontrol akses dianggap setara jika semua kondisi berikut ini benar:

• Setiap pengidentifikasi keamanan (SID) yang ada di salah satu token juga ada di token lainnya.
• Tidak ada atau kedua token dibatasi.
• Jika kedua token dibatasi, setiap SID yang dibatasi dalam satu token juga dibatasi dalam token lainnya.
• Setiap hak istimewa yang ada di salah satu token juga ada di token lainnya.

Fungsi ini tidak memiliki pustaka impor atau file header terkait; Anda harus memanggilnya menggunakan fungsi LoadLibrary dan GetProcAddress .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	Ntseapi.h
DLL	Ntdll.dll