Partager via

Spécification de l’étendue de recherche

  • Article

Vous pouvez spécifier l’étendue d’une recherche en tant que recherche de base, à un niveau ou sous-arborescence. Utilisez l’indicateur ADS_SEARCHPREF_SEARCH_SCOPE avec les valeurs de l’énumération ADS_SCOPEENUM pour spécifier l’étendue de recherche. La liste suivante comprend des descriptions des types de recherche :

  • Base. Une recherche de base limite la recherche à l’objet de base. Le nombre maximal d’objets retournés est toujours un. Cette recherche est utile pour vérifier l’existence d’un objet pour récupérer l’appartenance au groupe. Par exemple, si vous avez un nom unique d’objet et que vous devez vérifier l’existence de l’objet en fonction du chemin d’accès, vous pouvez utiliser une recherche à un niveau. Si la recherche échoue, vous pouvez supposer que l’objet a peut-être été renommé ou déplacé vers un autre emplacement, ou que vous avez reçu des informations incorrectes sur l’objet. N’oubliez pas que vous devez stocker l’identificateur global unique (GUID) de l’objet au lieu du nom unique, si vous souhaitez revisiter un objet. Le GUID référencera toujours le même objet, quel que soit l’emplacement de l’objet dans la hiérarchie de répertoires.
  • Un niveau. Une recherche à un niveau est limitée aux enfants immédiats d’un objet de base, mais exclut l’objet de base lui-même. Ce paramètre peut effectuer une recherche ciblée pour les objets enfants immédiats d’un objet parent. Par exemple, considérez un objet parent P1 et ses enfants immédiats : C1, C2 et C3. Une recherche à un niveau évalue C1, C2 et C3 par rapport aux critères de recherche, mais n’évalue pas P1. Utilisez une recherche à un niveau pour énumérer tous les enfants d’un objet. Une énumération IADsContainer se traduit par une recherche à un niveau.
  • Sous-arborescence. Une recherche de sous-arborescence (ou une recherche approfondie) inclut tous les objets enfants ainsi que l’objet de base. Vous pouvez demander au fournisseur LDAP de rechercher les références vers d’autres services d’annuaire LDAP, y compris d’autres domaines ou forêts d’annuaire.