énumération ADS_CHASE_REFERRALS_ENUM (iads.h)

Article
02/29/2024

L’énumération ADS_CHASE_REFERRALS_ENUM spécifie si, et comment, la poursuite des références se produit. Lorsqu’un serveur détermine que d’autres serveurs contiennent des données pertinentes, en partie ou en totalité, il peut diriger le client vers un autre serveur pour obtenir le résultat. La recherche de références est l’action effectuée par un client pour contacter le serveur référencé afin de poursuivre la recherche dans l’annuaire.

Syntax

typedef enum __MIDL___MIDL_itf_ads_0000_0000_0024 {
  ADS_CHASE_REFERRALS_NEVER = 0,
  ADS_CHASE_REFERRALS_SUBORDINATE = 0x20,
  ADS_CHASE_REFERRALS_EXTERNAL = 0x40,
  ADS_CHASE_REFERRALS_ALWAYS
} ADS_CHASE_REFERRALS_ENUM;

Constantes


`ADS_CHASE_REFERRALS_NEVER` Valeur : 0 Le client ne doit jamais poursuivre le serveur référencé. La définition de cette option empêche un client de contacter les autres serveurs lors d'un processus de référence.
`ADS_CHASE_REFERRALS_SUBORDINATE` Valeur : 0x20 Le client poursuit uniquement les références subordonnées qui sont un contexte de nommage subordonné dans une arborescence de répertoires. Par exemple, si la recherche de base est demandée pour « DC=Fabrikam,DC=Com » et que le serveur retourne un jeu de résultats et une référence de « DC=Sales,DC=Fabrikam,DC=Com » sur le serveur AdbSales, le client peut contacter le serveur AdbSales pour poursuivre la recherche. Le fournisseur LDAP ADSI désactive toujours cet indicateur pour les recherches paginées.
`ADS_CHASE_REFERRALS_EXTERNAL` Valeur : 0x40 Le client poursuit les références externes. Par exemple, un client demande au serveur A d’effectuer une recherche pour « DC=Fabrikam,DC=Com ». Toutefois, le serveur A ne contient pas l’objet, mais sait qu’un serveur indépendant, B, en est propriétaire. Il renvoie ensuite le client au serveur B.
`ADS_CHASE_REFERRALS_ALWAYS` Les références sont poursuivies pour le type subordonné ou externe.

Remarques

Utilisez les constantes de cette énumération pour configurer les préférences de recherche pour la poursuite des références. L’action revient à affecter les champs appropriés de la structure ADS_SEARCHPREF_INFO avec des éléments des énumérations ADS_CHASE_REFERRALS_ENUM et ADS_SEARCHPREF_ENUM . Les valeurs de cette énumération peuvent également être utilisées avec IADsObjectOptions pour spécifier si la poursuite des références doit avoir lieu lors de l’énumération des objets sous un objet conteneur.

L’interface IADsNameTranslate a une implémentation partielle de ADS_CHASE_REFERRALS_ENUM via la propriété ChaseReferral. Si la propriété ChaseReferral a la valeur zéro (0), cela revient à spécifier ADS_CHASE_REFERRALS_NEVER (0). Si une valeur différente de zéro est utilisée, cela revient à spécifier ADS_CHASE_REFERRALS_ALWAYS (0x60). IADsNameTranslate n’implémente pas les options ADS_CHASE_REFERRALS_SUBORDINATE (0x20) ou ADS_CHASE_REFERRALS_EXTERNAL (0x40).

Le fournisseur LDAP ADSI prend en charge les références externes pour les recherches paginées, mais ne prend pas en charge les références subordonnées pendant la pagination.

Note Étant donné que VBScript ne peut pas lire les données d’une bibliothèque de types, les applications VBScript ne comprennent pas les constantes symboliques définies ci-dessus. Vous devez utiliser les constantes numériques à la place pour définir les indicateurs appropriés dans vos applications VBScript. Si vous souhaitez utiliser les constantes symboliques comme bonne pratique de programmation, vous devez effectuer des déclarations explicites de ces constantes, comme cela est fait ici, dans vos applications VBScript.