Repérage de références avec IDirectorySearch

Une référence est le mécanisme utilisé par un serveur d’annuaire pour diriger un client vers un autre serveur lorsqu’il ne contient pas suffisamment de données sur l’objet demandé par une requête.

Dans une recherche de sous-arborescence ou de niveau unique, les références sont retournées pour les conteneurs de domaine, de schéma ou de configuration connus, immédiatement subordonnés. autrement dit, les domaines enfants qui sont des descendants directs. Pour plus d’informations, consultez étendue de recherche.

Dans un répertoire, toutes les données ne sont pas disponibles sur un serveur unique, mais elles sont distribuées sur plusieurs serveurs différents sur le réseau. Si les serveurs partagent les données que d’autres serveurs peuvent fournir, ils peuvent fournir des références à un client lorsqu’une requête demandée ne peut pas être résolue sur le serveur d’origine. Par exemple, lorsqu’un client demande au serveur A d’interroger un objet utilisateur (U), un peut suggérer que le client continue la recherche sur le serveur B si U ne réside pas sur un, mais qu’il est identifié sur B. Le client a la possibilité de poursuivre la référence. Les références permettent au client de devoir posséder une connaissance préalable de la capacité de chaque serveur, mais le client doit spécifier le type de références qu’un serveur doit effectuer.

Pour activer ou désactiver le repérage de références, définissez une option de recherche de _ _ _ références Chase SEARCHPREF pour les publicités avec une valeur _ entière ADSTYPE qui contient l’une des _ _ références _ de la recherche de recherches de publicités énumérer les valeurs d’énumération dans le tableau d' _ _ informations SEARCHPREF ADS passé à la méthode IDirectorySearch :: SetSearchPreference .

L’exemple de code suivant montre comment activer les références de Chase.

ADS_SEARCHPREF_INFO SearchPref;
SearchPref.dwSearchPref = ADS_SEARCHPREF_CHASE_REFERRALS;
SearchPref.vValue.dwType = ADSTYPE_INTEGER;
SearchPref.vValue.Integer = ADS_CHASE_REFERRALS_ALWAYS;

Pour plus d’informations sur les références dans Active Directory, consultez références.