énumération ADS_SCOPEENUM (iads.h)

Article
03/02/2024

L’énumération ADS_SCOPEENUM spécifie l’étendue d’une recherche d’annuaire.

Syntax

typedef enum __MIDL___MIDL_itf_ads_0000_0000_0021 {
  ADS_SCOPE_BASE = 0,
  ADS_SCOPE_ONELEVEL = 1,
  ADS_SCOPE_SUBTREE = 2
} ADS_SCOPEENUM;

Constantes


`ADS_SCOPE_BASE` Valeur : 0 Limite la recherche à l'objet de base. Le résultat contient, au maximum, un objet.
`ADS_SCOPE_ONELEVEL` Valeur : 1 Recherche un niveau des enfants immédiats, à l’exclusion de l’objet de base.
`ADS_SCOPE_SUBTREE` Valeur : 2 Recherche l’ensemble de la sous-arborescence, y compris tous les enfants et l’objet de base lui-même.

Remarques

Si vous ne définissez pas explicitement l’étendue de recherche, la valeur par défaut est ADS_SCOPE_SUBTREE.

Étant donné que VBScript ne peut pas lire les données d’une bibliothèque de types, les applications VBScript ne reconnaissent pas les constantes symboliques telles que définies ci-dessus. Utilisez plutôt les constantes numériques pour définir les indicateurs appropriés dans vos applications VBScript. Pour utiliser les constantes symboliques comme bonne pratique de programmation, créez des déclarations explicites de telles constantes, comme cela est fait ici, dans vos applications VBScript.

Exemples

L’étendue de recherche est l’une des préférences de recherche que les clients peuvent spécifier. L’exemple de code suivant montre comment effectuer cette opération à l’aide de la structure ADS_SEARCHPREF_INFO , ainsi que des éléments définis dans le ADS_SEARCHPREF_ENUM et cette énumération.

ADS_SEARCHPREF_INFO prefInfo;
prefInfo.dwSearchPref = ADS_SEARCHPREF_SEARCH_SCOPE;
prefInfo.vValue.dwType = ADSTYPE_INTEGER;
prefInfo.vValue.Integer = ADS_SCOPE_SUBTREE;

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
En-tête	iads.h

Voir aussi

Énumérations ADSI

ADS_SEARCHPREF_ENUM

ADS_SEARCHPREF_INFO

Partager via