enumerasi ADS_SEARCHPREF_ENUM (iads.h)

Artikel
08/24/2023

Enumerasi ADS_SEARCHPREF_ENUM menentukan preferensi untuk objek IDirectorySearch . Enumerasi ini digunakan dalam anggota dwSearchPref dari struktur ADS_SEARCHPREF_INFO dalam metode IDirectorySearch::SetSearchPreference .

Sintaks

typedef enum __MIDL___MIDL_itf_ads_0000_0000_0025 {
  ADS_SEARCHPREF_ASYNCHRONOUS = 0,
  ADS_SEARCHPREF_DEREF_ALIASES,
  ADS_SEARCHPREF_SIZE_LIMIT,
  ADS_SEARCHPREF_TIME_LIMIT,
  ADS_SEARCHPREF_ATTRIBTYPES_ONLY,
  ADS_SEARCHPREF_SEARCH_SCOPE,
  ADS_SEARCHPREF_TIMEOUT,
  ADS_SEARCHPREF_PAGESIZE,
  ADS_SEARCHPREF_PAGED_TIME_LIMIT,
  ADS_SEARCHPREF_CHASE_REFERRALS,
  ADS_SEARCHPREF_SORT_ON,
  ADS_SEARCHPREF_CACHE_RESULTS,
  ADS_SEARCHPREF_DIRSYNC,
  ADS_SEARCHPREF_TOMBSTONE,
  ADS_SEARCHPREF_VLV,
  ADS_SEARCHPREF_ATTRIBUTE_QUERY,
  ADS_SEARCHPREF_SECURITY_MASK,
  ADS_SEARCHPREF_DIRSYNC_FLAG,
  ADS_SEARCHPREF_EXTENDED_DN
} ADS_SEARCHPREF_ENUM;

Konstanta

ADS_SEARCHPREF_ASYNCHRONOUS
Nilai: 0
Menentukan bahwa pencarian harus dilakukan secara asinkron. Secara default, pencarian sinkron.

Dalam pencarian sinkron, metode IDirectorySearch::GetFirstRow dan IDirectorySearch::GetNextRow tidak kembali sampai server mengembalikan seluruh hasil, atau untuk pencarian halaman, seluruh halaman.

Pencarian asinkron memblokir hingga satu baris hasil pencarian tersedia, atau hingga interval batas waktu yang ditentukan oleh preferensi pencarian ADS_SEARCHPREF_TIMEOUT berlalu.

ADS_SEARCHPREF_DEREF_ALIASES
Menentukan bahwa alias objek yang ditemukan akan diselesaikan. Gunakan enumerasi ADS_DEREFENUM untuk menentukan bagaimana hal ini dilakukan.

ADS_SEARCHPREF_SIZE_LIMIT
Menentukan batas ukuran yang harus diamati server selama pencarian. Server berhenti mencari ketika batas ukuran tercapai dan mengembalikan hasil yang terakumulasi ke titik tersebut. Jika nilai ini nol, batas ukuran ditentukan oleh layanan direktori. Default untuk nilai ini adalah nol. Jika nilai ini lebih besar dari batas ukuran yang ditentukan oleh layanan direktori, batas layanan direktori lebih diutamakan.

Untuk Direktori Aktif, batas ukuran menentukan jumlah maksimum objek yang akan dikembalikan oleh pencarian. Selain itu untuk Direktori Aktif, jumlah maksimum objek yang dikembalikan oleh pencarian adalah 1000 objek.

ADS_SEARCHPREF_TIME_LIMIT
Menentukan jumlah detik server menunggu pencarian selesai. Ketika batas waktu tercapai, server berhenti mencari dan mengembalikan hasil yang terakumulasi ke titik tersebut. Jika nilai ini nol, periode batas waktu tidak terbatas. Default untuk nilai ini adalah 120 detik.

ADS_SEARCHPREF_ATTRIBTYPES_ONLY
Menunjukkan bahwa pencarian hanya boleh mendapatkan nama atribut yang nilainya ditetapkan.

ADS_SEARCHPREF_SEARCH_SCOPE
Menentukan cakupan pencarian yang harus diamati oleh server. Untuk informasi selengkapnya tentang pengaturan yang sesuai, lihat enumerasi ADS_SCOPEENUM .

ADS_SEARCHPREF_TIMEOUT
Menentukan batas waktu, dalam detik, bahwa klien akan menunggu server mengembalikan hasilnya. Opsi ini diatur dalam struktur ADS_SEARCHPREF_INFO .

ADS_SEARCHPREF_PAGESIZE
Menentukan ukuran halaman dalam pencarian halaman. Untuk setiap permintaan oleh klien, server mengembalikan, paling banyak, jumlah objek sebagaimana diatur oleh ukuran halaman. Ketika ukuran halaman diatur, tidak perlu mengatur batas ukuran. Jika batas ukuran diatur, maka nilai untuk ukuran halaman harus kurang dari nilai untuk batas ukuran. Jika nilai untuk ukuran halaman melebihi batas ukuran, maka kesalahan ERROR_DS_SIZELIMIT_EXCEEDED dikembalikan dengan jumlah baris yang ditentukan oleh batas ukuran.

ADS_SEARCHPREF_PAGED_TIME_LIMIT
Menentukan jumlah detik server harus menunggu halaman hasil pencarian, dibandingkan dengan batas waktu untuk seluruh pencarian. Ketika batas waktu tercapai, server berhenti mencari dan mengembalikan hasil yang diperoleh hingga saat itu, bersama dengan cookie yang berisi data tentang tempat melanjutkan pencarian. Jika nilai ini nol, periode batas waktu halaman tidak terbatas. Nilai default untuk batas ini adalah 120 detik.

ADS_SEARCHPREF_CHASE_REFERRALS
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 diabaikan atau dikejar. Untuk informasi selengkapnya tentang pengejaran rujukan, lihat ADS_CHASE_REFERRALS_ENUM.

ADS_SEARCHPREF_SORT_ON
Menentukan bahwa server mengurutkan kumpulan hasil. Gunakan struktur ADS_SORTKEY untuk menentukan kunci pengurutan. Preferensi pencarian ini hanya berfungsi untuk server direktori yang mendukung kontrol LDAP untuk pengurutan sisi server. Direktori Aktif mendukung kontrol pengurutan, tetapi dapat memengaruhi performa server, terutama jika kumpulan hasilnya besar. Direktori Aktif hanya mendukung satu kunci pengurutan.

ADS_SEARCHPREF_CACHE_RESULTS
Menentukan apakah hasilnya harus di-cache di sisi klien. Secara default, ADSI menyimpan kumpulan hasil. Menonaktifkan opsi ini mungkin diinginkan untuk tataan hasil besar.

ADS_SEARCHPREF_DIRSYNC
Menentukan pencarian sinkronisasi direktori (DirSync), yang mengembalikan semua perubahan sejak status yang ditentukan. Dalam struktur ADSVALUE , atur anggota dwType ke ADS_PROV_SPECIFIC. Anggota ProviderSpecific adalah struktur ADS_PROV_SPECIFIC yang anggota lpValue-nya menentukan cookie yang menunjukkan status dari mana perubahan diambil. Pertama kali Anda menggunakan kontrol DirSync, atur anggota dwLength dan lpValue dari struktur ADS_PROV_SPECIFIC ke nol dan NULL masing-masing. Setelah membaca hasil yang dikembalikan oleh pencarian hingga IDirectorySearch::GetNextRow mengembalikan S_ADS_NOMORE_ROWS, panggil IDirectorySearch::GetColumn untuk mengambil atribut ADS_DIRSYNC_COOKIE yang berisi cookie untuk digunakan dalam pencarian DirSync berikutnya. Untuk informasi selengkapnya, lihat Polling untuk Perubahan Menggunakan Kontrol DirSync dan LDAP_SERVER_DIRSYNC_OID.

Bendera ini tidak dapat digabungkan dengan ADS_SEARCHPREF_PAGESIZE.

Penelepon harus memiliki hak istimewa SE_SYNC_AGENT_NAME .

ADS_SEARCHPREF_TOMBSTONE
Menentukan apakah pencarian juga harus mengembalikan objek yang dihapus yang cocok dengan filter pencarian. Saat objek dihapus, Direktori Aktif memindahkannya ke kontainer "Objek Dihapus". Secara default, objek yang dihapus tidak disertakan dalam hasil pencarian. Dalam struktur ADSVALUE , atur anggota dwType ke ADSTYPE_BOOLEAN. Untuk menyertakan objek yang dihapus, atur anggota Boolean dari struktur ADSVALUE ke TRUE.

Tidak semua atribut dipertahankan saat objek dihapus. Anda dapat mengambil atribut objectGUID dan RDN . Atribut distinguishedName adalah DN objek dalam kontainer "Objek Dihapus", bukan DN sebelumnya. Atribut isDeleted adalah TRUE untuk objek yang dihapus. Untuk informasi selengkapnya, lihat Mengambil Objek Yang Dihapus.

ADS_SEARCHPREF_VLV
Menentukan bahwa pencarian harus menggunakan kontrol tampilan daftar virtual (VLV) LDAP. ADS_SEARCHPREF_VLV dapat digunakan untuk mengakses pencarian VLV jenis string dan tipe offset, dengan mengatur bidang yang sesuai. Kedua opsi ini tidak dapat digunakan secara bersamaan karena tidak dimungkinkan untuk mengatur kontrol VLV untuk meminta tataan hasil yang keduanya terletak pada offset tertentu dan mengikuti nilai tertentu dalam urutan pengurutan.

Untuk melakukan pencarian string, atur bidang lpszTarget di ADS_VLV ke string yang akan dicari. Untuk melakukan pencarian jenis offset, atur bidang dwOffset di ADS_VLV. Jika Anda menggunakan pencarian offset, Anda harus mengatur lpszTarget ke NULL.

ADS_SEARCHPREF_SORT_ON harus diatur ke TRUE saat menggunakan ADS_SEARCHPREF_VLV. Urutan pengurutan hasil pencarian menentukan urutan yang digunakan untuk pencarian VLV. Jika melakukan pencarian jenis offset, offset digunakan sebagai indeks ke dalam daftar yang diurutkan. Jika melakukan pencarian jenis string, server mencoba mengembalikan entri pertama yang lebih besar dari-atau-sama dengan string, berdasarkan urutan pengurutan.

Penembolokan hasil pencarian dinonaktifkan saat ADS_SEARCHPREF_VLV ditentukan.

Jika Anda menetapkan ADS_SEARCHPREF_CACHE_RESULTSTRUE, nilai saat menggunakan ADS_SEARCHPREF_VLV, SetSearchPreference akan gagal dan mengembalikan kesalahan E_ADS_BAD_PARAMETER.

ADS_SEARCHPREF_ATTRIBUTE_QUERY
Menentukan bahwa pencarian kueri dengan cakupan atribut harus dilakukan. Pencarian dilakukan terhadap objek yang dinamai dalam atribut tertentu dari objek dasar. Anggota vValue dari struktur ADS_SEARCHPREF_INFO berisi nilai ADSTYPE_CASE_IGNORE_STRING yang berisi lDAPDisplayName atribut untuk dicari. Atribut ini harus berupa atribut ADS_DN_STRING . Hanya satu atribut yang dapat ditentukan. Cakupan pencarian secara otomatis diatur ke ADS_SCOPE_BASE saat menggunakan preferensi ini, dan mencoba mengatur cakupan jika tidak, akan gagal dengan kesalahan E_ADS_BAD_PARAMETER. Dengan pengecualian preferensi ADS_SEARCHPREF_VLV , semua preferensi lain yang menggunakan kontrol LDAP, seperti ADS_SEARCHPREF_DIRSYNC, ADS_SEARCHPREF_TOMBSTONE, dan sebagainya, tidak diizinkan ketika preferensi ini ditentukan.

ADS_SEARCHPREF_SECURITY_MASK
Menentukan bahwa pencarian harus mengembalikan data akses keamanan untuk atribut yang ditentukan. Anggota vValue dari struktur ADS_SEARCHPREF_INFO berisi nilai ADS_INTEGER yang merupakan kombinasi dari satu atau beberapa nilai berikut.

Nilai	Deskripsi
ADS_SECURITY_INFO_OWNER	Membaca data pemilik.
ADS_SECURITY_INFO_GROUP	Membaca data grup.
ADS_SECURITY_INFO_DACL	Membaca daftar kontrol akses diskresi (DACL).
ADS_SECURITY_INFO_SACL	Membaca daftar kontrol akses sistem (SACL).

Jika Anda membaca deskriptor keamanan tanpa secara eksplisit menentukan masker keamanan menggunakan ADS_SEARCHPREF_SECURITY_MASK, defaultnya setara dengan ADS_SECURITY_INFO_OWNER

ADS_SECURITY_INFO_GROUP

ADS_SECURITY_INFO_DACL.

ADS_SEARCHPREF_DIRSYNC_FLAG
Berisi bendera opsional untuk digunakan dengan preferensi pencarian ADS_SEARCHPREF_DIRSYNC . Anggota vValue dari struktur ADS_SEARCHPREF_INFO berisi nilai ADSTYPE_INTEGER yang nol atau kombinasi dari satu atau beberapa nilai berikut. Untuk informasi selengkapnya tentang kontrol DirSync, lihat Polling untuk Perubahan Menggunakan Kontrol DirSync dan LDAP_SERVER_DIRSYNC_OID.

Pengidentifikasi	Nilai	Deskripsi
LDAP_DIRSYNC_OBJECT_SECURITY	1	Jika bendera ini tidak ada, pemanggil harus memiliki perubahan replikasi yang tepat. Jika bendera ini ada, pemanggil tidak memerlukan hak, tetapi hanya diizinkan untuk melihat objek dan atribut yang dapat diakses oleh pemanggil.
LDAP_DIRSYNC_ANCESTORS_FIRST_ORDER	2048 (0x00000800)	Mengembalikan objek induk sebelum objek anak, ketika objek induk akan muncul nanti di aliran replikasi.
LDAP_DIRSYNC_PUBLIC_DATA_ONLY	8192 (0x00002000)	Jangan mengembalikan data privat dalam hasil pencarian.
LDAP_DIRSYNC_INCREMENTAL_VALUES	2147483648 (0x80000000)	Jika bendera ini tidak ada, semua nilai, hingga batas yang ditentukan server, dalam atribut multinilai dikembalikan saat nilai berubah. Jika bendera ini ada, hanya nilai yang diubah yang dikembalikan.

ADS_SEARCHPREF_EXTENDED_DN
Pencarian harus mengembalikan nama yang dibedakan dalam format diperluas Direktori Aktif. Anggota vValue dari struktur ADS_SEARCHPREF_INFO berisi nilai ADSTYPE_INTEGER yang berisi nol jika bagian GUID dan SID dari string DN harus dalam format hex atau satu jika bagian GUID dan SID dari string DN harus dalam format standar. Untuk informasi selengkapnya tentang nama khusus yang diperluas, lihat LDAP_SERVER_EXTENDED_DN_OID.

Keterangan

Untuk menyiapkan preferensi pencarian, tetapkan nilai yang sesuai ke bidang struktur ADS_SEARCHPREF_INFO yang diteruskan ke server. Anggota vValue dari struktur ADS_SEARCHPREF_INFO adalah struktur ADSVALUE . Daftar berikut mencantumkan nilai ADS_SEARCHPREF_ENUM , nilai terkait untuk anggota dwType dari struktur ADSVALUE , dan anggota ADSVALUE yang digunakan untuk jenis yang ditentukan.

nilai ADS_SEARCHPREF_ENUM	dwType anggota ADSVALUE	Anggota ADSVALUE
ADS_SEARCHPREF_ASYNCHRONOUS	ADSTYPE_BOOLEAN	Boolean
ADS_SEARCHPREF_DEREF_ALIASES	ADSTYPE_INTEGER	Bilangan bulat
ADS_SEARCHPREF_SIZE_LIMIT	ADSTYPE_INTEGER	Bilangan bulat
ADS_SEARCHPREF_TIME_LIMIT	ADSTYPE_INTEGER	Bilangan bulat
ADS_SEARCHPREF_ATTRIBTYPES_ONLY	ADSTYPE_BOOLEAN	Boolean
ADS_SEARCHPREF_SEARCH_SCOPE	ADSTYPE_INTEGER	Bilangan bulat
ADS_SEARCHPREF_TIMEOUT	ADSTYPE_INTEGER	Bilangan bulat
ADS_SEARCHPREF_PAGESIZE	ADSTYPE_INTEGER	Bilangan bulat
ADS_SEARCHPREF_PAGED_TIME_LIMIT	ADSTYPE_INTEGER	Bilangan bulat
ADS_SEARCHPREF_CHASE_REFERRALS	ADSTYPE_INTEGER	Bilangan bulat
ADS_SEARCHPREF_SORT_ON	ADSTYPE_PROV_SPECIFIC	ProviderSpecific
ADS_SEARCHPREF_CACHE_RESULTS	ADSTYPE_BOOLEAN	Boolean
ADS_SEARCHPREF_DIRSYNC	ADSTYPE_PROV_SPECIFIC	ProviderSpecific
ADS_SEARCHPREF_TOMBSTONE	ADSTYPE_BOOLEAN	Boolean
ADS_SEARCHPREF_VLV	ADSTYPE_PROV_SPECIFIC	ProviderSpecific
ADS_SEARCHPREF_ATTRIBUTE_QUERY	ADSTYPE_CASE_IGNORE_STRING	CaseIgnoreString
ADS_SEARCHPREF_SECURITY_MASK	ADSTYPE_INTEGER	Bilangan bulat
ADS_SEARCHPREF_DIRSYNC_FLAG	ADSTYPE_INTEGER	Bilangan bulat
ADS_SEARCHPREF_EXTENDED_DN	ADSTYPE_INTEGER	Bilangan bulat

Untuk menyiapkan beberapa preferensi, gunakan array struktur ADS_SEARCHPREF_INFO . Nilai anggota enumerasi ini ditetapkan ke anggota dwSearchPref dari struktur ADS_SEARCHPREF_INFO .

Semua opsi didukung oleh penyedia sistem LDAP.

Karena VBScript tidak dapat membaca data dari pustaka jenis, aplikasi VBScript tidak mengenali konstanta simbolis seperti yang ditentukan di atas. Anda harus menggunakan 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 tersebut, seperti yang dilakukan di sini, dalam aplikasi VBScript Anda.

Contoh

Contoh kode berikut menunjukkan cara menyiapkan preferensi pencarian menggunakan enumerasi ADS_SEARCHPREF_INFO .

HRESULT SetSearchPreferences2(
    DWORD dwScope,// -1 indicates default: subtree.
    DWORD dwOverallTimeOut,// <=0 indicates default: no time out set.
    DWORD dwOverallSizeLimit,// <=0 indicates default: no size limit set.
    DWORD dwOverallTimeLimit,// <=0 indicates default: no time limit set.
    BOOL bCacheResult,// TRUE indicates default.
    BOOL bIsAsynchronous,// FALSE indicates default.
    DWORD dwPageSize,// <=0 indicates default.
    DWORD dwPageTimeLimit,// <=0 indicates default.
    DWORD dwChaseReferral,// <=0 indicates default.
    LPOLESTR szSortKey,// NULL indicates do not sort.
    BOOL bIsDescending,
    BOOL bReturnAttributeNamesOnly,// FALSE indicates default.
    ADS_SEARCHPREF_INFO **ppSearchPref, // Return an array of search preferences.
    DWORD *pdwSearchPrefCount
)
{
   HRESULT hr = S_OK;
   DWORD dwCountPref = 0L;
 
   // Determine size of preferences array.
   DWORD dwTotal = 11L;
 
   if(dwScope==-1)
       dwTotal--;
   if(dwOverallTimeOut<=0)
       dwTotal--;
   if(dwOverallSizeLimit<=0)
       dwTotal--;
   if(dwOverallTimeLimit<=0)
       dwTotal--;
   if(bCacheResult)
       dwTotal--;
   if(!bIsAsynchronous)
       dwTotal--;
   if(dwPageSize<=0)
       dwTotal--;
   if(dwPageTimeLimit<=0)
       dwTotal--;
   if(dwChaseReferral<=0)
       dwTotal--;
   if(!bReturnAttributeNamesOnly)
       dwTotal--;
   if (!szSortKey)
       dwTotal--;
 
   ADS_SEARCHPREF_INFO *prefInfo = new ADS_SEARCHPREF_INFO[ dwTotal ];
   ADS_SORTKEY SortKey;

    if(!prefInfo)
    {
        return E_OUTOFMEMORY;
    }
 
    //////////////////
    // Search Scope
    //////////////////
    if(dwScope>=0)
    {
        prefInfo[dwCountPref].dwSearchPref =
                         ADS_SEARCHPREF_SEARCH_SCOPE;
        prefInfo[dwCountPref].vValue.dwType = ADSTYPE_INTEGER;
        prefInfo[dwCountPref].vValue.Integer = dwScope;
        dwCountPref++;
    }
 
    //////////////////
    // Time Out
    //////////////////
    if(dwOverallTimeOut>0)
    {
       prefInfo[dwCountPref].dwSearchPref = ADS_SEARCHPREF_TIMEOUT;
       prefInfo[dwCountPref].vValue.dwType = ADSTYPE_INTEGER;
       prefInfo[dwCountPref].vValue.Integer = dwOverallTimeOut;
       dwCountPref++;
    }
 
    ///////////////
    // Size Limit
    ///////////////
    if(dwOverallSizeLimit>0)
    {
       prefInfo[dwCountPref].dwSearchPref = ADS_SEARCHPREF_SIZE_LIMIT;
       prefInfo[dwCountPref].vValue.dwType = ADSTYPE_INTEGER;
       prefInfo[dwCountPref].vValue.Integer = dwOverallSizeLimit;
       dwCountPref++;
    }
 
    ///////////////
    // Time Limit
    ///////////////
    if(dwOverallTimeLimit>0) 
    {
       prefInfo[dwCountPref].dwSearchPref = ADS_SEARCHPREF_TIME_LIMIT;
       prefInfo[dwCountPref].vValue.dwType = ADSTYPE_INTEGER;
       prefInfo[dwCountPref].vValue.Integer = dwOverallTimeLimit;
       dwCountPref++;
    }
 
    /////////////////
    // Cache Result
    /////////////////
 
    if (!bCacheResult)
    {
        prefInfo[dwCountPref].dwSearchPref =
                              ADS_SEARCHPREF_CACHE_RESULTS;
        prefInfo[dwCountPref].vValue.dwType = ADSTYPE_BOOLEAN;
        prefInfo[dwCountPref].vValue.Boolean = bCacheResult;
        dwCountPref++;
    }
 
    //////////////
    // Page Size
    //////////////
    if(dwPageSize>0)
    {
        prefInfo[dwCountPref].dwSearchPref = ADS_SEARCHPREF_PAGESIZE;
        prefInfo[dwCountPref].vValue.dwType = ADSTYPE_INTEGER;;
        prefInfo[dwCountPref].vValue.Integer = dwPageSize;
        dwCountPref++;
    }
 
    //////////////////
    // Page Time Limit
    //////////////////
    if(dwPageTimeLimit>0)
    {
        prefInfo[dwCountPref].dwSearchPref = 
                                      ADS_SEARCHPREF_PAGED_TIME_LIMIT;
        prefInfo[dwCountPref].vValue.dwType = ADSTYPE_INTEGER;;
        prefInfo[dwCountPref].vValue.Integer = dwPageTimeLimit;
        dwCountPref++;
    }
 
    ///////////////////
    // Chase Referrals
    ///////////////////
    if(dwChaseReferral>0)
    {
        prefInfo[dwCountPref].dwSearchPref =
                                      ADS_SEARCHPREF_CHASE_REFERRALS;
        prefInfo[dwCountPref].vValue.dwType = ADSTYPE_INTEGER;
        prefInfo[dwCountPref].vValue.Integer = dwChaseReferral;
        dwCountPref++;
    }
 
    /////////////
    // Sort
    /////////////
    if (szSortKey)
    {
        prefInfo[dwCountPref].dwSearchPref = ADS_SEARCHPREF_SORT_ON;
        prefInfo[dwCountPref].vValue.dwType = ADSTYPE_PROV_SPECIFIC;
        SortKey.pszAttrType = (LPWSTR)LocalAlloc(
                        LPTR,
                        wcslen(szSortKey)*sizeof(WCHAR) +sizeof(WCHAR)
                        );
        wcscpy_s(SortKey.pszAttrType,szSortKey);
        SortKey.pszReserved = NULL;
        SortKey.fReverseorder = 0;
        prefInfo[dwCountPref].vValue.ProviderSpecific.dwLength = 
                                                 sizeof(ADS_SORTKEY);
        prefInfo[dwCountPref].vValue.ProviderSpecific.lpValue = 
                                                 (LPBYTE) &SortKey;
        dwCountPref++;
    }
    
    /////////////////
    // Asynchronous
    /////////////////
    if(bIsAsynchronous)
    {
        prefInfo[dwCountPref].dwSearchPref =
                                     ADS_SEARCHPREF_ASYNCHRONOUS;
        prefInfo[dwCountPref].vValue.dwType = ADSTYPE_BOOLEAN;
        prefInfo[dwCountPref].vValue.Integer = bIsAsynchronous;
        dwCountPref++;
    }
 
    ////////////////////////
    // Attribute Type Only
    ////////////////////////
    if(bReturnAttributeNamesOnly)
    {
        prefInfo[dwCountPref].dwSearchPref =
                                  ADS_SEARCHPREF_ATTRIBTYPES_ONLY;
        prefInfo[dwCountPref].vValue.dwType = ADSTYPE_BOOLEAN;
        prefInfo[dwCountPref].vValue.Integer = 
                                  bReturnAttributeNamesOnly;
        dwCountPref++;
    }
 
    if (SUCCEEDED(hr))
    {
        *pdwSearchPrefCount = dwCountPref;
        *ppSearchPref  = prefInfo;
    }
    else
    {
        *pdwSearchPrefCount = 0L;
        *ppSearchPref  = NULL;
    }
 
 
    return hr;
}