enumeración ADS_SCOPEENUM (iads.h)

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;

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Encabezado	iads.h

Consulte también

Enumeraciones ADSI

ADS_SEARCHPREF_ENUM

ADS_SEARCHPREF_INFO