Utilisation de la méthode SetSearchPreference

L’appel de la méthode IDirectorySearch :: SetSearchPreference modifie la façon dont les résultats de la recherche sont obtenus et présentés via l’interface IDirectorySearch .

La documentation du kit de développement logiciel (SDK) définit SetSearchPreference comme suit :

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

Plusieurs préférences peuvent être définies en passant un tableau en tant que premier paramètre et la taille du tableau comme deuxième paramètre.

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);

Cet exemple définit la taille de la page sur 100 lignes et l’étendue sur _ le _ type de sous-arborescence étendue ads. Le paramètre taille de la page oblige le serveur à retourner immédiatement des données au client, après 100 lignes calculées. Le _ paramètre de sous-arborescence étendue ADS _ fait que la recherche englobe toutes les branches de l’arborescence sous le point à partir duquel la recherche est exécutée.