Export (0) Print
Expand All

IADsNameTranslate Property Methods

The property method of the IADsNameTranslate interface sets the ChaseReferral property. For more information, see Interface Property Methods.

Properties

ChaseReferral
Options of referral chasing as defined in ADS_CHASE_REFERRALS_ENUM. When referral chasing is set, the name translation is performed on objects that do not belong to this directory and are the referrals returned from referral chasing.
Access type: Write-only
Scripting data type: LONG
// C++ method syntax
 
 HRESULT put_ChaseReferral(
   [in] LONG lnChaseReferral
      
      
);

     
    

 

Remarks

The referral chasing options apply only when you use IADsNameTranslate::Set and IADsNameTranslate::Get. The feature is not available with IADsNameTranslate::SetEx or IADsNameTranslate::GetEx.

The IADsNameTranslate interface has a partial implementation of ADS_CHASE_REFERRALS_ENUM through the ChaseReferral property. If the ChaseReferral property is set to zero (0), it is the same as specifying ADS_CHASE_REFERRALS_NEVER (0). If a nonzero value is used, it is the same as specifying ADS_CHASE_REFERRALS_ALWAYS (0x60). IADsNameTranslate does not implement the ADS_CHASE_REFERRALS_SUBORDINATE (0x20) or ADS_CHASE_REFERRALS_EXTERNAL (0x40) options.

The default setting for referral chasing is enabled (ADS_CHASE_REFERRALS_ALWAYS). Without referral chasing, you can have name translation performed on those objects residing on the connected directory server only. If you are uncertain whether the object of interest is on the specified server, you should set this property to be ADS_CHASE_REFERRALS_ALWAYS.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2003

Header

Iads.h

DLL

Activeds.dll

IID

IID_IADsNameTranslate is defined as B1B272A3-3625-11D1-A3A4-00C04FB950DC

See also

ADS_CHASE_REFERRALS_ENUM
IADsNameTranslate
IADsNameTranslate::Get
IADsNameTranslate::GetEx
IADsNameTranslate::Set
IADsNameTranslate::SetEx
Interface Property Methods

 

 

Show:
© 2014 Microsoft