enumerasi ADS_PREFERENCES_ENUM (iads.h)

Artikel
08/24/2023

Enumerasi ADS_PREFERENCES_ENUM menentukan preferensi kueri penyedia OLE DB untuk ADSI.

Sintaks

typedef enum __MIDL___MIDL_itf_ads_0000_0000_0022 {
  ADSIPROP_ASYNCHRONOUS = 0,
  ADSIPROP_DEREF_ALIASES = 0x1,
  ADSIPROP_SIZE_LIMIT = 0x2,
  ADSIPROP_TIME_LIMIT = 0x3,
  ADSIPROP_ATTRIBTYPES_ONLY = 0x4,
  ADSIPROP_SEARCH_SCOPE = 0x5,
  ADSIPROP_TIMEOUT = 0x6,
  ADSIPROP_PAGESIZE = 0x7,
  ADSIPROP_PAGED_TIME_LIMIT = 0x8,
  ADSIPROP_CHASE_REFERRALS = 0x9,
  ADSIPROP_SORT_ON = 0xa,
  ADSIPROP_CACHE_RESULTS = 0xb,
  ADSIPROP_ADSIFLAG = 0xc
} ADS_PREFERENCES_ENUM;

Konstanta


`ADSIPROP_ASYNCHRONOUS` Nilai: 0 Meminta pencarian asinkron.
`ADSIPROP_DEREF_ALIASES` Nilai: 0x1 Menentukan bahwa alias objek yang ditemukan akan diselesaikan. Gunakan ADS_DEREFENUM untuk menentukan cara melakukan operasi ini.
`ADSIPROP_SIZE_LIMIT` Nilai: 0x2 Menentukan batas ukuran yang harus diamati server dalam pencarian. Batas ukuran adalah jumlah maksimum objek yang dikembalikan. Nilai nol menunjukkan bahwa tidak ada batas ukuran yang diberlakukan. Server berhenti mencari setelah batas ukuran tercapai dan mengembalikan hasil yang terakumulasi hingga saat itu.
`ADSIPROP_TIME_LIMIT` Nilai: 0x3 Menentukan batas waktu, dalam detik, yang harus diamati server dalam pencarian. Nilai nol menunjukkan bahwa tidak ada pembatasan batas waktu yang diberlakukan. Ketika batas waktu tercapai, server berhenti mencari dan mengembalikan hasil yang terakumulasi ke titik tersebut.
`ADSIPROP_ATTRIBTYPES_ONLY` Nilai: 0x4 Menunjukkan bahwa pencarian seharusnya hanya mendapatkan nama atribut yang nilainya telah ditetapkan.
`ADSIPROP_SEARCH_SCOPE` Nilai: 0x5 Menentukan cakupan pencarian yang harus diamati oleh server. Untuk informasi selengkapnya tentang pengaturan yang sesuai, lihat enumerasi ADS_SCOPEENUM .
`ADSIPROP_TIMEOUT` Nilai: 0x6 Menentukan batas waktu, dalam detik, bahwa klien akan menunggu server mengembalikan hasilnya.
`ADSIPROP_PAGESIZE` Nilai: 0x7 Menentukan ukuran halaman dalam pencarian halaman. Untuk setiap permintaan oleh klien, server mengembalikan, paling banyak, jumlah objek sebagaimana diatur oleh ukuran halaman.
`ADSIPROP_PAGED_TIME_LIMIT` Nilai: 0x8 Menentukan batas waktu, dalam detik, yang harus diamati server untuk mencari halaman hasil; ini berlawanan dengan batas waktu untuk seluruh pencarian.
`ADSIPROP_CHASE_REFERRALS` Nilai: 0x9 Menentukan bahwa rujukan dapat dikejar. Jika pencarian akar tidak ditentukan dalam konteks penamaan server atau ketika hasil pencarian melewati konteks penamaan (misalnya, ketika Anda memiliki domain anak dan mencari di domain induk), server mengirim pesan rujukan ke klien yang dapat dipilih klien untuk mengabaikan atau mengejar. Secara default, opsi ini diatur ke ADS_CHASE_REFERRALS_EXTERNAL. Untuk informasi selengkapnya tentang pengejaran rujukan, lihat ADS_CHASE_REFERRALS_ENUM.
`ADSIPROP_SORT_ON` Nilai: 0xa Menentukan bahwa server mengurutkan kumpulan hasil. Gunakan struktur ADS_SORTKEY untuk menentukan kunci pengurutan.
`ADSIPROP_CACHE_RESULTS` Nilai: 0xb Menentukan apakah hasilnya harus di-cache di sisi klien. Secara default, ADSI menyimpan kumpulan hasil. Menonaktifkan opsi ini mungkin lebih diinginkan untuk tataan hasil besar.
`ADSIPROP_ADSIFLAG` Nilai: 0xc Memungkinkan klien OLEDB menentukan bendera ikatan untuk digunakan saat mengikat ke server. Nilai yang valid adalah nilai yang diizinkan oleh ADsOpenObject. Ini diakses dari skrip ADO menggunakan nama properti "Bendera ADSI."

Keterangan

Karena VBScript tidak dapat membaca data dari pustaka jenis, aplikasi VBScript tidak mengenali konstanta simbolis seperti yang ditentukan di atas. Sebagai gantinya, gunakan konstanta numerik untuk mengatur bendera yang sesuai di aplikasi VBScript Anda. Untuk menggunakan konstanta simbolis, sebagai praktik pemrograman yang baik, tulis deklarasi eksplisit konstanta tersebut, seperti yang dilakukan di sini, dalam aplikasi VBScript Anda.