ADS_PREFERENCES_ENUM enumeração (iads.h)

Artigo
03/09/2024

A enumeração ADS_PREFERENCES_ENUM especifica as preferências de consulta do provedor OLE DB para ADSI.

Syntax

typedef enum __MIDL___MIDL_itf_ads_0000_0000_0022 {
  ADSIPROP_ASYNCHRONOUS = 0,
  ADSIPROP_DEREF_ALIASES = 0x1,
  ADSIPROP_SIZE_LIMIT = 0x2,
  ADSIPROP_TIME_LIMIT = 0x3,
  ADSIPROP_ATTRIBTYPES_ONLY = 0x4,
  ADSIPROP_SEARCH_SCOPE = 0x5,
  ADSIPROP_TIMEOUT = 0x6,
  ADSIPROP_PAGESIZE = 0x7,
  ADSIPROP_PAGED_TIME_LIMIT = 0x8,
  ADSIPROP_CHASE_REFERRALS = 0x9,
  ADSIPROP_SORT_ON = 0xa,
  ADSIPROP_CACHE_RESULTS = 0xb,
  ADSIPROP_ADSIFLAG = 0xc
} ADS_PREFERENCES_ENUM;

Constantes


`ADSIPROP_ASYNCHRONOUS` Valor: 0 Solicita uma pesquisa assíncrona.
`ADSIPROP_DEREF_ALIASES` Valor: 0x1 Especifica que os aliases dos objetos encontrados devem ser resolvidos. Use ADS_DEREFENUM para especificar como executar essa operação.
`ADSIPROP_SIZE_LIMIT` Valor: 0x2 Especifica o limite de tamanho que o servidor deve observar em uma pesquisa. O limite de tamanho é o número máximo de objetos retornados. Um valor zero indica que nenhum limite de tamanho é imposto. O servidor para de pesquisar quando o limite de tamanho é atingido e retorna os resultados acumulados até esse ponto.
`ADSIPROP_TIME_LIMIT` Valor: 0x3 Especifica o limite de tempo, em segundos, que o servidor deve observar em uma pesquisa. Um valor zero indica que nenhuma restrição de limite de tempo é imposta. Quando o limite de tempo é atingido, o servidor para de pesquisar e retorna os resultados acumulados para esse ponto.
`ADSIPROP_ATTRIBTYPES_ONLY` Valor: 0x4 Indica que a pesquisa deve obter apenas o nome dos atributos aos quais os valores foram atribuídos.
`ADSIPROP_SEARCH_SCOPE` Valor: 0x5 Especifica o escopo de pesquisa que deve ser observado pelo servidor. Para obter mais informações sobre as configurações apropriadas, consulte a enumeração ADS_SCOPEENUM .
`ADSIPROP_TIMEOUT` Valor: 0x6 Especifica o limite de tempo, em segundos, que um cliente aguardará o servidor retornar o resultado.
`ADSIPROP_PAGESIZE` Valor: 0x7 Especifica o tamanho da página em uma pesquisa paginada. Para cada solicitação do cliente, o servidor retorna, no máximo, o número de objetos conforme definido pelo tamanho da página.
`ADSIPROP_PAGED_TIME_LIMIT` Valor: 0x8 Especifica o limite de tempo, em segundos, que o servidor deve observar para pesquisar uma página de resultados; isso se opõe ao limite de tempo para toda a pesquisa.
`ADSIPROP_CHASE_REFERRALS` Valor: 0x9 Especifica que as indicações podem ser perseguidas. Se a pesquisa raiz não for especificada no contexto de nomenclatura do servidor ou quando os resultados da pesquisa cruzarem um contexto de nomenclatura (por exemplo, quando você tiver domínios filho e pesquisar no domínio pai), o servidor enviará uma mensagem de indicação para o cliente que o cliente pode optar por ignorar ou perseguir. Por padrão, essa opção é definida como ADS_CHASE_REFERRALS_EXTERNAL. Para obter mais informações sobre a busca de indicações, consulte ADS_CHASE_REFERRALS_ENUM.
`ADSIPROP_SORT_ON` Valor: 0xa Especifica que o servidor classifica o conjunto de resultados. Use a estrutura ADS_SORTKEY para especificar as chaves de classificação.
`ADSIPROP_CACHE_RESULTS` Valor: 0xb Especifica se o resultado deve ser armazenado em cache no lado do cliente. Por padrão, o ADSI armazena em cache o conjunto de resultados. Desativar essa opção pode ser mais desejável para conjuntos de resultados grandes.
`ADSIPROP_ADSIFLAG` Valor: 0xc Permite que o cliente OLEDB especifique sinalizadores de associação a serem usados ao associar ao servidor. Os valores válidos são aqueles permitidos por ADsOpenObject. Ele é acessado de scripts do ADO usando o nome da propriedade "Sinalizador ADSI".

Comentários

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 seu aplicativo VBScript. Para usar as constantes simbólicas, como uma boa prática de programação, escreva declarações explícitas dessas constantes, conforme feito aqui, em seu aplicativo VBScript.