次の方法で共有


IDirectorySearch でのサイズ制限

メモリ要件を減らすか、その他の目的で、クライアントはサーバーから返される少数のオブジェクトに集中し、関心のない結果セットの残りの部分を無視できます。 これを実現するために、クライアントは検索サイズの制限とその他の適切な検索条件を指定します。 たとえば、ディレクトリに学区のテスト スコアが格納されている場合、10 のサイズ制限と降順の並べ替え順序を指定することで、テスト スコアが最も高い上位 10 人の学生にクエリを実行できます。

サイズ制限の既定値に制限はありません。 サイズ制限を設定するには、IDirectorySearch::SetSearchPreference メソッドに渡される ADS_SEARCHPREF_INFO 配列の最大サイズを含む ADSTYPE_INTEGER 値を使用して、ADS_SEARCHPREF_SIZE_LIMIT 検索オプションを設定します。

サイズ制限を設定する方法を次のコード例に示します。 サイズ制限値が 0 の場合は、サイズ制限がないことを示します。

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

Active Directory の場合、サイズ制限は、検索によって返されるオブジェクトの最大数を指定します。 Active Directory の場合も、検索によって返されるオブジェクトの最大数は 1,000 オブジェクトです。