Compartilhar via


ADS_SCOPEENUM enumeração (iads.h)

A enumeração ADS_SCOPEENUM especifica o escopo de uma pesquisa de diretório.

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 a pesquisa ao objeto base. O resultado contém, no máximo, um objeto .
ADS_SCOPE_ONELEVEL
Valor: 1
Pesquisa um nível dos filhos imediatos, excluindo o objeto base.
ADS_SCOPE_SUBTREE
Valor: 2
Pesquisa toda a subárvore, incluindo todos os filhos e o próprio objeto base.

Comentários

Se você não definir explicitamente o escopo de pesquisa, o padrão será ADS_SCOPE_SUBTREE.

Como o VBScript não pode ler dados de uma biblioteca de tipos, os aplicativos VBScript não reconhecem as constantes simbólicas conforme definido acima. Use as constantes numéricas, em vez disso, para definir os sinalizadores apropriados em seus aplicativos VBScript. Para usar as constantes simbólicas como uma boa prática de programação, crie declarações explícitas dessas constantes, conforme feito aqui, em seus aplicativos VBScript.

Exemplos

O escopo da pesquisa é uma das preferências de pesquisa que os clientes podem especificar. O exemplo de código a seguir mostra como fazer isso usando a estrutura ADS_SEARCHPREF_INFO , juntamente com os elementos definidos no ADS_SEARCHPREF_ENUM e essa enumeração.

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Cabeçalho iads.h

Confira também

Enumerações ADSI

ADS_SEARCHPREF_ENUM

ADS_SEARCHPREF_INFO