大网数据广告活动
域与目录服务

IADsNameTranslate Property Methods (Iads.h)

· 52CE 我爱测

Sets the ChaseReferral property.

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

Requirement Value
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
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

Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / Windows Win32 documentation
适用范围
Windows Win32 API · Source date 05/31/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。