Directory Services

IADsNameTranslate Property Methods

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


Property Description

[Visual Basic]
Access: Write-only
DataType: LONG

HRESULT put_ChaseReferral
([in] LONG lnChaseReferral);

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.


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 default setting for referral chasing is on. 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.


Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Redistributable: Requires Active Directory Client Extension on Windows NT 4.0 SP6a and Windows 95/98/Me.
Header: Declared in Iads.h.

See Also

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