Bagikan melalui

Menggunakan Metode SetSearchPreference

  • Artikel

Memanggil metode IDirectorySearch::SetSearchPreference mengubah cara hasil pencarian diperoleh dan disajikan melalui antarmuka IDirectorySearch.

Dokumentasi SDK mendefinisikan SetSearchPreference sebagai berikut:

HRESULT SetSearchPreference(
            //Search preferences to be set.
            PADS_SEARCHPREF_INFO pSearchPrefs,
            //Number of preferences.
            DWORD dwNumPrefs
            );

Beberapa preferensi dapat diatur dengan meneruskan array sebagai parameter pertama dan ukuran array sebagai parameter kedua.

ADS_SEARCHPREF_INFO arSearchPrefs[2];
 
arSearchPrefs[0].dwSearchPref = ADS_SEARCHPREF_PAGESIZE; 
arSearchPrefs[0].vValue.dwType = ADSTYPE_INTEGER;
arSearchPrefs[0].vValue.Integer = 100;
 
arSearchPrefs[1].dwSearchPref = ADS_SEARCHPREF_SEARCH_SCOPE; 
arSearchPrefs[1].vValue.dwType = ADSTYPE_INTEGER; 
arSearchPrefs[1].vValue.Integer = ADS_SCOPE_SUBTREE; 
 
hr = pDSearch->SetSearchPreference(&arSearchPrefs, 2);

Contoh ini mengatur ukuran halaman menjadi 100 baris dan cakupan ke jenis ADS_SCOPE_SUBTREE. Pengaturan ukuran halaman menyebabkan server segera mengembalikan data ke klien, setelah 100 baris dihitung. Pengaturan ADS_SCOPE_SUBTREE menyebabkan pencarian mencakup semua cabang di pohon di bawah titik tempat pencarian dijalankan.