é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_BASEValeur : 0 Limite la recherche à l'objet de base. Le résultat contient, au maximum, un objet. |
ADS_SCOPE_ONELEVELValeur : 1 Recherche un niveau des enfants immédiats, à l’exclusion de l’objet de base. |
ADS_SCOPE_SUBTREEValeur : 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 |