通过

IDirectorySearch 的大小限制

  • 项目

为了减少内存需求或用于其他目的，客户端可以将注意力集中在从服务器返回的少量对象上，而忽略不感兴趣的结果集的其余部分。 为此，客户需要指定搜索大小限制和其他适当的搜索标准。 例如，如果目录中存储了一个学区的考试分数，那么你可以通过指定十 (10) 名学生的大小限制和降序排序来查询考试分数最高的前十名学生。

大小限制的默认值没有限制。 若要设置大小限制，请使用 ADSTYPE_INTEGER 值设置一个 ADS_SEARCHPREF_SIZE_LIMIT 搜索选项，该值包含传递给 IDirectorySearch::SetSearchPreference 方法的 ADS_SEARCHPREF_INFO 数组中的最大大小。

以下代码示例显示如何设置大小限制。 大小限制值为零表示没有大小限制。

ADS_SEARCHPREF_INFO SearchPref;
SearchPref.dwSearchPref = ADS_SEARCHPREF_SIZE_LIMIT;
SearchPref.vValue.dwType = ADSTYPE_INTEGER;
SearchPref.vValue.Integer = 1000;

对于 Active Directory，大小限制指定要由搜索返回的最大对象数。 同样对于 Active Directory，搜索返回的最大对象数为 1000 个对象。