Fungsi EqualPrefixSid (securitybaseapi.h)

Artikel
03/01/2024

Fungsi EqualPrefixSid menguji dua nilai awalan pengidentifikasi keamanan (SID) untuk kesetaraan. Awalan SID adalah seluruh SID kecuali untuk nilai subautoritas terakhir.

Sintaks

BOOL EqualPrefixSid(
  [in] PSID pSid1,
  [in] PSID pSid2
);

Parameter

[in] pSid1

Penunjuk ke struktur SID pertama yang akan dibandingkan. Struktur ini diasumsikan valid.

[in] pSid2

Penunjuk ke struktur SID kedua untuk dibandingkan. Struktur ini diasumsikan valid.

Nilai kembali

Jika awalan SID sama, nilai yang dikembalikan bukan nol.

Jika awalan SID tidak sama, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Fungsi EqualPrefixSid memungkinkan aplikasi server dalam satu domain untuk memverifikasi upaya pengguna untuk masuk ke domain lain. Misalnya, jika pengguna mencoba masuk ke RemoteDomain dari stasiun kerja di LocalDomain, server untuk LocalDomain dapat meminta SID untuk pengguna dan grup pengguna dari RemoteDomain. Pengendali domain untuk RemoteDomain merespons dengan SID yang relevan.

Semua SID untuk domain tertentu memiliki awalan yang sama. Ketika server menerima SID pengguna, server dapat memanggil fungsi EqualPrefixSid untuk setiap SID, membandingkan SID pengguna atau grup dengan SID untuk RemoteDomain. Jika salah satu prefiks SID tidak sama, server menolak upaya masuk.

Dianjurkan untuk memodifikasi SID untuk domain sebelum membandingkannya dengan SID grup atau pengguna. Jika SID untuk RemoteDomain adalah S-1–1234–8, setiap grup atau pengguna SID untuk domain tersebut memiliki S-1–1234–8 sebagai awalannya. Untuk membandingkan SID dengan menggunakan fungsi EqualPrefixSid , aplikasi menyalin SID domain dan menambahkan nilai subautoritas (RID) apa pun ke salinan, sehingga membuat SID dalam bentuk S-1–1234–8–0. Aplikasi kemudian menggunakan SID domain yang dimodifikasi sebagai templat yang dibandingkan dengan SID grup dan pengguna.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	securitybaseapi.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll