ADS_CHASE_REFERRALS_ENUM 枚举 (iads.h)

ADS_CHASE_REFERRALS_ENUM枚举指定是否以及如何发生引荐追逐。 当服务器确定其他服务器持有部分或整个相关数据时,它可能会将客户端引用到另一台服务器以获取结果。 引荐追查是客户端为联系引用的服务器以继续目录搜索而执行的操作。

语法

typedef enum __MIDL___MIDL_itf_ads_0000_0000_0024 {
  ADS_CHASE_REFERRALS_NEVER = 0,
  ADS_CHASE_REFERRALS_SUBORDINATE = 0x20,
  ADS_CHASE_REFERRALS_EXTERNAL = 0x40,
  ADS_CHASE_REFERRALS_ALWAYS
} ADS_CHASE_REFERRALS_ENUM;

常量

 
ADS_CHASE_REFERRALS_NEVER
值: 0
客户端绝不应追逐引用的服务器。 设置此选项可防止客户端在检索进程中联系其他服务器。
ADS_CHASE_REFERRALS_SUBORDINATE
值: 0x20
客户端仅追查目录树中的从属命名上下文的从属引用。 例如,如果请求“DC=Fabrikam,DC=Com”的基本搜索,并且服务器在 AdbSales 服务器上返回结果集和引用“DC=Sales,DC=Fabrikam,DC=Com”,则客户端可以联系 AdbSales 服务器以继续搜索。 对于分页搜索,ADSI LDAP 提供程序始终会关闭这一标记。
ADS_CHASE_REFERRALS_EXTERNAL
值: 0x40
客户端追逐外部引荐。 例如,客户端请求服务器 A 执行搜索“DC=Fabrikam,DC=Com”。 但是,服务器 A 不包含对象,但知道独立服务器 B 拥有该对象。 然后,它将客户端引用到服务器 B。
ADS_CHASE_REFERRALS_ALWAYS
将针对从属或外部类型追逐引荐。

注解

使用此枚举的常量设置用于引荐追查的搜索首选项。 该操作相当于使用ADS_CHASE_REFERRALS_ENUMADS_SEARCHPREF_ENUM枚举的元素分配ADS_SEARCHPREF_INFO结构的相应字段。 此枚举的值还可以与 IADsObjectOptions 一起使用,以指定在枚举容器对象下的对象时是否应进行引用追查。

IADsNameTranslate 接口通过 ChaseReferral 属性的部分实现ADS_CHASE_REFERRALS_ENUM。 如果 ChaseReferral 属性设置为零 (0) ,则它与指定 ADS_CHASE_REFERRALS_NEVER (0) 相同。 如果使用非零值,则与指定 ADS_CHASE_REFERRALS_ALWAYS (0x60) 相同。 IADsNameTranslate 不实现 ADS_CHASE_REFERRALS_SUBORDINATE (0x20) 或 ADS_CHASE_REFERRALS_EXTERNAL (0x40) 选项。

ADSI LDAP 提供程序支持分页搜索的外部引用,但在分页期间不支持从属引用。

注意 由于 VBScript 无法从类型库读取数据,因此 VBScript 应用程序无法理解上面定义的符号常量。 应改用数字常量在 VBScript 应用程序中设置适当的标志。 如果要将符号常量用作良好的编程做法,则应在 VBScript 应用程序中对此类常量进行显式声明,如此处所示。
 

要求

要求
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
标头 iads.h

另请参阅

ADSI 枚举

ADS_SEARCHPREF_ENUM

ADS_SEARCHPREF_INFO

IADsNameTranslate

IADsObjectOptions