Menentukan Cakupan Pencarian
Anda dapat menentukan cakupan pencarian sebagai pencarian dasar, satu tingkat, atau subtree. Gunakan bendera ADS_SEARCHPREF_SEARCH_SCOPE dengan nilai enumerasi ADS_SCOPEENUM untuk menentukan cakupan pencarian. Daftar berikut ini mencakup deskripsi jenis pencarian:
- Dasar. Pencarian dasar membatasi pencarian ke objek dasar. Jumlah maksimum objek yang dikembalikan selalu satu. Pencarian ini berguna untuk memverifikasi keberadaan objek untuk mengambil keanggotaan grup. Misalnya, jika Anda memiliki nama khusus objek, dan Anda harus memverifikasi keberadaan objek berdasarkan jalur, Anda dapat menggunakan pencarian satu tingkat. Jika pencarian gagal, Anda dapat mengasumsikan bahwa objek mungkin telah diganti namanya atau dipindahkan ke lokasi lain, atau Anda diberi informasi yang salah tentang objek tersebut. Ketahuilah bahwa Anda harus menyimpan pengidentifikasi unik global (GUID) objek alih-alih nama khusus, jika Anda ingin mengunjungi kembali objek. GUID akan selalu mereferensikan objek yang sama, terlepas dari di mana objek berada dalam hierarki direktori.
- Satu tingkat. Pencarian satu tingkat dibatasi untuk anak-anak langsung dari objek dasar, tetapi mengecualikan objek dasar itu sendiri. Pengaturan ini dapat melakukan pencarian yang ditargetkan untuk objek turunan langsung dari objek induk. Misalnya, pertimbangkan objek induk P1 dan turunan langsungnya: C1, C2, dan C3. Pencarian satu tingkat mengevaluasi C1, C2, dan C3 terhadap kriteria pencarian, tetapi tidak mengevaluasi P1. Gunakan pencarian satu tingkat untuk menghitung semua anak objek. Enumerasi IADsContainer diterjemahkan ke pencarian satu tingkat.
- Subtree. Pencarian subtree (atau pencarian mendalam) mencakup semua objek anak serta objek dasar. Anda dapat meminta penyedia LDAP untuk mengejar rujukan ke layanan direktori LDAP lainnya, termasuk domain direktori atau forest lainnya.