enumerasi ADS_DEREFENUM (iads.h)

Artikel
02/28/2024

Enumerasi ADS_DEREFENUM menentukan proses di mana alias didereferensikan.

Sintaks

typedef enum __MIDL___MIDL_itf_ads_0000_0000_0020 {
  ADS_DEREF_NEVER = 0,
  ADS_DEREF_SEARCHING = 1,
  ADS_DEREF_FINDING = 2,
  ADS_DEREF_ALWAYS = 3
} ADS_DEREFENUM;

Konstanta


`ADS_DEREF_NEVER` Nilai: 0 Tidak mendereferensikan alias saat mencari atau menemukan objek dasar pencarian.
`ADS_DEREF_SEARCHING` Nilai: 1 Dereferensi alias saat mencari bawahan objek dasar, tetapi tidak saat menemukan basis itu sendiri.
`ADS_DEREF_FINDING` Nilai: 2 Dereferensi alias saat menemukan objek dasar pencarian, tetapi tidak saat mencari bawahannya.
`ADS_DEREF_ALWAYS` Nilai: 3 Dereferensi alias saat mencari bawahan dan menemukan objek dasar pencarian.

Keterangan

Antarmuka IDirectorySearch menggunakan konstanta ini untuk mengatur perilaku dereferensi alias. Jika tidak ada opsi yang ditentukan, server default ke ADS_DEREF_NEVER.

Catatan Karena VBScript tidak dapat membaca data dari pustaka jenis, aplikasi VBScript tidak mengenali konstanta simbolis seperti yang ditentukan di atas. Gunakan konstanta numerik, sebagai gantinya, untuk mengatur bendera yang sesuai di aplikasi VBScript Anda. Untuk menggunakan konstanta simbolis, sebagai praktik pemrograman yang baik, secara eksplisit menyatakan konstanta, seperti yang dilakukan di sini.

Contoh

Contoh kode berikut menunjukkan cara mengatur preferensi pencarian untuk dereferensi alias. m_pSearch mengacu pada penunjuk ke objek yang mengimplementasikan antarmuka IDirectorySearch .

ADS_SEARCHPREF_INFO prefInfo[1];
HRESULT hr;
 
prefInfo[0].dwSearchPref   = ADS_SEARCHPREF_DEREF_ALIASES;
prefInfo[0].vValue.dwType  = ADSTYPE_INTEGER;
prefInfo[0].vValue.Integer = ADS_DEREF_ALWAYS;
hr = m_pSearch->SetSearchPreference(prefInfo, 1);

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Header	iads.h

Lihat juga

Enumerasi ADSI

IDirectorySearch

Bagikan melalui