ADS_CHASE_REFERRALS_ENUM enumeração (iads.h)

Artigo
02/26/2024

A enumeração ADS_CHASE_REFERRALS_ENUM especifica se e como ocorrerão a busca de referência. Quando um servidor determina que outros servidores contêm dados relevantes, em parte ou como um todo, ele pode encaminhar o cliente para outro servidor para obter o resultado. A busca de referência é a ação executada por um cliente para entrar em contato com o servidor referenciado para continuar a pesquisa de diretório.

Syntax

typedef enum __MIDL___MIDL_itf_ads_0000_0000_0024 {
  ADS_CHASE_REFERRALS_NEVER = 0,
  ADS_CHASE_REFERRALS_SUBORDINATE = 0x20,
  ADS_CHASE_REFERRALS_EXTERNAL = 0x40,
  ADS_CHASE_REFERRALS_ALWAYS
} ADS_CHASE_REFERRALS_ENUM;

Constantes


`ADS_CHASE_REFERRALS_NEVER` Valor: 0 O cliente nunca deve perseguir o servidor referenciado. A configuração dessa opção impede que um cliente entre em contato com outros servidores em um processo de referência.
`ADS_CHASE_REFERRALS_SUBORDINATE` Valor: 0x20 O cliente busca apenas indicações subordinadas que são um contexto de nomenclatura subordinado em uma árvore de diretório. Por exemplo, se a pesquisa base for solicitada para "DC=Fabrikam,DC=Com", e o servidor retornar um conjunto de resultados e uma indicação de "DC=Sales,DC=Fabrikam,DC=Com" no servidor AdbSales, o cliente poderá entrar em contato com o servidor AdbSales para continuar a pesquisa. O provedor LDAP ADSI sempre desativa esse sinalizador para pesquisas paginadas.
`ADS_CHASE_REFERRALS_EXTERNAL` Valor: 0x40 O cliente busca indicações externas. Por exemplo, um cliente solicita que o servidor A execute uma pesquisa por "DC=Fabrikam,DC=Com". No entanto, o servidor A não contém o objeto , mas sabe que um servidor independente, B, o possui. Em seguida, ele refere o cliente ao servidor B.
`ADS_CHASE_REFERRALS_ALWAYS` As indicações são perseguidas para o tipo subordinado ou externo.

Comentários

Use as constantes dessa enumeração para configurar preferências de pesquisa para perseguição de indicação. A ação equivale a atribuir os campos apropriados da estrutura ADS_SEARCHPREF_INFO com elementos das enumerações ADS_CHASE_REFERRALS_ENUM e ADS_SEARCHPREF_ENUM . Os valores dessa enumeração também podem ser usados com IADsObjectOptions para especificar se a perseguição de indicação deve ocorrer ao enumerar os objetos em um objeto de contêiner.

A interface IADsNameTranslate tem uma implementação parcial de ADS_CHASE_REFERRALS_ENUM por meio da propriedade ChaseReferral . Se a propriedade ChaseReferral estiver definida como zero (0), ela será a mesma que especificar ADS_CHASE_REFERRALS_NEVER (0). Se um valor diferente de zero for usado, ele será o mesmo que especificar ADS_CHASE_REFERRALS_ALWAYS (0x60). IADsNameTranslate não implementa as opções ADS_CHASE_REFERRALS_SUBORDINATE (0x20) ou ADS_CHASE_REFERRALS_EXTERNAL (0x40).

O provedor LDAP ADSI dá suporte a indicações externas para pesquisas paginados, mas não dá suporte a indicações subordinadas durante a paginação.

Nota Como o VBScript não pode ler dados de uma biblioteca de tipos, os aplicativos VBScript não entendem as constantes simbólicas conforme definido acima. Em vez disso, você deve usar as constantes numéricas para definir os sinalizadores apropriados em seus aplicativos VBScript. Se você quiser usar as constantes simbólicas como uma boa prática de programação, deverá fazer declarações explícitas dessas constantes, como feito aqui, em seus aplicativos VBScript.