enumerasi ADS_CHASE_REFERRALS_ENUM (iads.h)

Artikel
02/26/2024

Enumerasi ADS_CHASE_REFERRALS_ENUM menentukan apakah, dan bagaimana, pengejaran rujukan terjadi. Ketika server menentukan bahwa server lain menyimpan data yang relevan, sebagian atau secara keseluruhan, server dapat merujuk klien ke server lain untuk mendapatkan hasilnya. Pengejaran rujukan adalah tindakan yang diambil oleh klien untuk menghubungi server yang dirujuk untuk melanjutkan pencarian direktori.

Sintaks

typedef enum __MIDL___MIDL_itf_ads_0000_0000_0024 {
  ADS_CHASE_REFERRALS_NEVER = 0,
  ADS_CHASE_REFERRALS_SUBORDINATE = 0x20,
  ADS_CHASE_REFERRALS_EXTERNAL = 0x40,
  ADS_CHASE_REFERRALS_ALWAYS
} ADS_CHASE_REFERRALS_ENUM;

Konstanta


`ADS_CHASE_REFERRALS_NEVER` Nilai: 0 Klien tidak boleh mengejar server yang dirujuk. Mengatur opsi ini mencegah klien menghubungi server lain dalam proses rujukan.
`ADS_CHASE_REFERRALS_SUBORDINATE` Nilai: 0x20 Klien hanya mengejar rujukan bawahan yang merupakan konteks penamaan bawahan di pohon direktori. Misalnya, jika pencarian dasar diminta untuk "DC=Fabrikam,DC=Com", dan server mengembalikan tataan hasil dan rujukan "DC=Sales,DC=Fabrikam,DC=Com" di server AdbSales, klien dapat menghubungi server AdbSales untuk melanjutkan pencarian. Penyedia ADSI LDAP selalu menonaktifkan bendera ini untuk pencarian halaman.
`ADS_CHASE_REFERRALS_EXTERNAL` Nilai: 0x40 Klien mengejar rujukan eksternal. Misalnya, klien meminta server A untuk melakukan pencarian untuk "DC=Fabrikam,DC=Com". Namun, server A tidak berisi objek , tetapi tahu bahwa server independen, B, memilikinya. Kemudian merujuk klien ke server B.
`ADS_CHASE_REFERRALS_ALWAYS` Rujukan dikejar untuk jenis bawahan atau eksternal.

Keterangan

Gunakan konstanta enumerasi ini untuk menyiapkan preferensi pencarian untuk pengejaran rujukan. Jumlah tindakan untuk menetapkan bidang yang sesuai dari struktur ADS_SEARCHPREF_INFO dengan elemen enumerasi ADS_CHASE_REFERRALS_ENUM dan ADS_SEARCHPREF_ENUM . Nilai enumerasi ini juga dapat digunakan dengan IADsObjectOptions untuk menentukan apakah pengejaran rujukan harus terjadi saat menghitung objek di bawah objek kontainer.

Antarmuka IADsNameTranslate memiliki implementasi parsial ADS_CHASE_REFERRALS_ENUM melalui properti ChaseReferral . Jika properti ChaseReferral diatur ke nol (0), properti tersebut sama dengan menentukan ADS_CHASE_REFERRALS_NEVER (0). Jika nilai bukan nol digunakan, nilainya sama dengan menentukan ADS_CHASE_REFERRALS_ALWAYS (0x60). IADsNameTranslate tidak menerapkan opsi ADS_CHASE_REFERRALS_SUBORDINATE (0x20) atau ADS_CHASE_REFERRALS_EXTERNAL (0x40).

Penyedia ADSI LDAP mendukung rujukan eksternal untuk pencarian halaman, tetapi tidak mendukung rujukan bawahan selama penomor.

Catatan Karena VBScript tidak dapat membaca data dari pustaka jenis, aplikasi VBScript tidak memahami konstanta simbolis seperti yang didefinisikan di atas. Anda harus menggunakan konstanta numerik sebagai gantinya untuk mengatur bendera yang sesuai di aplikasi VBScript Anda. Jika Anda ingin menggunakan konstanta simbolis sebagai praktik pemrograman yang baik, Anda harus membuat deklarasi eksplisit konstanta tersebut, seperti yang dilakukan di sini, dalam aplikasi VBScript Anda.