ADS_CHASE_REFERRALS_ENUM

The ADS_CHASE_REFERRALS_ENUM enumeration specifies how referral chasing occurs.

When a server determines that other servers hold relevant data, 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 only 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

  • The client always chases referrals, regardless of the type.

Requirements

Minimum required version: 2009.1

See also

© Softerra 2022. All rights reserved.
Send feedback