Fungsi EqualPrefixSid (securitybaseapi.h)
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 |