Partager via


énumération ADS_SCOPEENUM (iads.h)

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