ADS_CHASE_REFERRALS_ENUM

The ADS_CHASE_REFERRALS_ENUM enumeration specifies, if, and how referral chasing occurs. When a server determines that other servers hold relevant data, in part or as a whole, it can refer the client to another server to obtain the result. Referral chasing is the action taken by a client to contact the referred-to server to continue the directory search.

Syntax

enum ADS_CHASE_REFERRALS_ENUM
{
  ADS_CHASE_REFERRALS_NEVER         = 0,   //0x00
  ADS_CHASE_REFERRALS_SUBORDINATE   = 32,  //0x20
  ADS_CHASE_REFERRALS_EXTERNAL      = 64,  //0x40
  ADS_CHASE_REFERRALS_ALWAYS        = 96,  //0x60
}

Constants

  • Flag

  • Description

  • ADS_CHASE_REFERRALS_NEVER

  • The client should never chase the referred-to server. Setting this option prevents a client from contacting other servers in a referral process.

  • ADS_CHASE_REFERRALS_SUBORDINATE

  • The client chases only subordinate referrals which are a subordinate naming context in a directory tree. For example, if the base search is requested for "DC=domain,DC=com", and the server returns a result set and a referral of "DC=Sales,DC=domain,DC=com" on the MyServer server, the client can contact the MyServer server to continue the search.

  • ADS_CHASE_REFERRALS_EXTERNAL

  • The client chases external referrals. For example, a client requests server A to perform a search for "DC=domain,DC=com". However, server A does not contain the object, but knows that an independent server, B, owns it. It then refers the client to server B.

  • ADS_CHASE_REFERRALS_ALWAYS

  • Referrals are chased for either the subordinate or external type.

Requirements

Minimum required version: 2009.1

See also