enumeración ADS_SCOPEENUM (iads.h)

Artículo
02/26/2024

La enumeración ADS_SCOPEENUM especifica el ámbito de una búsqueda de directorios.

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` Valor: 0 Limita la búsqueda al objeto base. El resultado contiene, como máximo, un objeto .
`ADS_SCOPE_ONELEVEL` Valor: 1 Busca en un nivel de los elementos secundarios inmediatos, excepto el objeto base.
`ADS_SCOPE_SUBTREE` Valor: 2 Busca en todo el subárbol, incluidos todos los elementos secundarios y el propio objeto base.

Comentarios

Si no establece explícitamente el ámbito de búsqueda, el valor predeterminado es ADS_SCOPE_SUBTREE.

Dado que VBScript no puede leer datos de una biblioteca de tipos, las aplicaciones VBScript no reconocen las constantes simbólicas como se ha definido anteriormente. Use las constantes numéricas, en su lugar, para establecer las marcas adecuadas en las aplicaciones vbScript. Para usar las constantes simbólicas como práctica de programación recomendada, cree declaraciones explícitas de estas constantes, como se hace aquí, en las aplicaciones vbScript.

Ejemplos

El ámbito de búsqueda es uno de los clientes de preferencias de búsqueda que pueden especificar. En el ejemplo de código siguiente se muestra cómo hacerlo mediante la estructura ADS_SEARCHPREF_INFO , junto con los elementos definidos en el ADS_SEARCHPREF_ENUM y esta enumeración.

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