Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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_BASEValor: 0 Limita a pesquisa ao objeto base. O resultado contém, no máximo, um objeto . |
ADS_SCOPE_ONELEVELValor: 1 Pesquisa um nível dos filhos imediatos, excluindo o objeto base. |
ADS_SCOPE_SUBTREEValor: 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 |