Limite de taille avec IDirectorySearch
Pour réduire les besoins en mémoire ou à d’autres fins, le client peut se concentrer sur un petit nombre d’objets retournés par le serveur et ignorer le reste du jeu de résultats qui ne sont pas intéressants. Pour ce faire, le client spécifie la limite de taille de recherche et d’autres critères de recherche appropriés. Par exemple, si l’annuaire stocke les scores de test d’une circonscription scolaire, vous pouvez interroger les dix meilleurs étudiants avec les meilleurs scores de test en spécifiant une limite de taille de dix (10) et un ordre de tri décroissant.
La valeur par défaut de la limite de taille est illimitée. Pour définir une limite de taille, définissez une option de recherche de _ limite de _ taille _ de SEARCHPREF ADS avec une valeur _ entière ADSTYPE qui contient la taille maximale dans le tableau d' _ _ informations SEARCHPREF ADS passé à la méthode IDirectorySearch :: SetSearchPreference .
L’exemple de code suivant montre comment définir la limite de taille. Une valeur de limite de taille de zéro indique aucune limite de taille.
ADS_SEARCHPREF_INFO SearchPref;
SearchPref.dwSearchPref = ADS_SEARCHPREF_SIZE_LIMIT;
SearchPref.vValue.dwType = ADSTYPE_INTEGER;
SearchPref.vValue.Integer = 1000;
Par Active Directory, la limite de taille spécifie le nombre maximal d’objets qui doivent être retournés par la recherche. Par ailleurs, pour Active Directory, le nombre maximal d’objets renvoyés par une recherche est de 1000 objets.