Compartilhar via

ADS_DEREFENUM enumeração (iads.h)

  • Artigo

A enumeração ADS_DEREFENUM especifica o processo por meio do qual os aliases são desreferenciados.

Syntax

typedef enum __MIDL___MIDL_itf_ads_0000_0000_0020 {
  ADS_DEREF_NEVER = 0,
  ADS_DEREF_SEARCHING = 1,
  ADS_DEREF_FINDING = 2,
  ADS_DEREF_ALWAYS = 3
} ADS_DEREFENUM;

Constantes

 
ADS_DEREF_NEVER
Valor: 0
Não desreferencia aliases ao pesquisar ou localizar o objeto base da pesquisa.
ADS_DEREF_SEARCHING
Valor: 1
Desreferencia os aliases ao pesquisar subordinados do objeto base, mas não ao localizar a base em si.
ADS_DEREF_FINDING
Valor: 2
Desreferencia os aliases ao localizar os objetos base da pesquisa, mas não ao pesquisar seus subordinados.
ADS_DEREF_ALWAYS
Valor: 3
Desreferencia os aliases ao pesquisar subordinados e localizar o objeto base da pesquisa.

Comentários

A interface IDirectorySearch usa essas constantes para definir o comportamento de desreferenciamento de alias. Se nenhuma opção for especificada, o servidor usará como padrão ADS_DEREF_NEVER.

Nota 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. Em vez disso, use as constantes numéricas para definir os sinalizadores apropriados em seus aplicativos VBScript. Para usar as constantes simbólicas, como uma boa prática de programação, declare explicitamente constantes, conforme feito aqui.
 

Exemplos

O exemplo de código a seguir mostra como definir a preferência de pesquisa para desreferenciamento de alias. m_pSearch refere-se a um ponteiro para um objeto que implementa a interface IDirectorySearch .

ADS_SEARCHPREF_INFO prefInfo[1];
HRESULT hr;
 
prefInfo[0].dwSearchPref   = ADS_SEARCHPREF_DEREF_ALIASES;
prefInfo[0].vValue.dwType  = ADSTYPE_INTEGER;
prefInfo[0].vValue.Integer = ADS_DEREF_ALWAYS;
hr = m_pSearch->SetSearchPreference(prefInfo, 1);

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

Idirectorysearch