ADS_SCOPEENUM枚举 (iads.h)

ADS_SCOPEENUM枚举指定目录搜索的范围。

语法

typedef enum __MIDL___MIDL_itf_ads_0000_0000_0021 {
  ADS_SCOPE_BASE = 0,
  ADS_SCOPE_ONELEVEL = 1,
  ADS_SCOPE_SUBTREE = 2
} ADS_SCOPEENUM;

常量

 
ADS_SCOPE_BASE
值: 0
将搜索限于基对象。 结果最多包含一个 对象。
ADS_SCOPE_ONELEVEL
值:1
搜索直接子级的一个级别,不包括基对象。
ADS_SCOPE_SUBTREE
值: 2
搜索整个子树,包括所有子树和基对象本身。

注解

如果未显式设置搜索范围,则默认值为 ADS_SCOPE_SUBTREE

由于 VBScript 无法从类型库读取数据,因此 VBScript 应用程序无法识别上面定义的符号常量。 请改用数字常量在 VBScript 应用程序中设置相应的标志。 若要将符号常量用作良好的编程做法,请在 VBScript 应用程序中创建此类常量的显式声明,如此处所述。

示例

搜索范围是客户端可以指定的搜索首选项之一。 下面的代码示例演示如何使用 ADS_SEARCHPREF_INFO 结构以及 ADS_SEARCHPREF_ENUM 和此枚举中定义的元素来实现此目的。

ADS_SEARCHPREF_INFO prefInfo;
prefInfo.dwSearchPref = ADS_SEARCHPREF_SEARCH_SCOPE;
prefInfo.vValue.dwType = ADSTYPE_INTEGER;
prefInfo.vValue.Integer = ADS_SCOPE_SUBTREE;

要求

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

另请参阅

ADSI 枚举

ADS_SEARCHPREF_ENUM

ADS_SEARCHPREF_INFO