検索範囲の指定

検索のスコープは、ベース、1 レベル、またはサブツリーの検索として指定できます。 検索範囲を指定するには、ADS_Standard EditionARCHPREF_Standard EditionARCH_SCOPE フラグを ADS_SCOPEnterprise Edition NUM 列挙の値と共に使用します。 次の一覧には、検索の種類の説明が含まれています。

• Base。 基本検索では、検索を基本オブジェクトに制限します。 返されるオブジェクトの最大数は常に 1 です。 この検索は、グループ メンバーシップを取得するためのオブジェクトの存在を確認するのに役立ちます。 たとえば、オブジェクトの識別名があり、パスに基づいてオブジェクトの存在を確認する必要がある場合は、1 レベルの検索を使用できます。 検索が失敗した場合は、オブジェクトの名前が変更されたか、別の場所に移動された可能性がある、またはオブジェクトに関する間違った情報が与えられたと見なすことができます。 オブジェクトを再訪する場合は、識別名の代わりにオブジェクトのグローバル一意識別子 (GUID) を格納する必要があることに注意してください。 GUID は、オブジェクトがディレクトリ階層内のどこにあるかに関係なく、常に同じオブジェクトを参照します。
• 1 レベル。 1 レベルの検索は、基本オブジェクトの直下の子に制限されますが、基本オブジェクト自体は除外されます。 この設定では、親オブジェクトの直接の子オブジェクトを対象とした検索を実行できます。 たとえば、親オブジェクト P1 とその直下の子 (C1、C2、C3) について考えてみます。 1 レベルの検索では、検索条件に対して C1、C2、C3 が評価されますが、P1 は評価されません。 1 レベルの検索を使用して、オブジェクトのすべての子を列挙します。 IADsContainer 列挙体は、1 レベルの検索に変換されます。
• サブツリー。 サブツリー検索 (またはディープ検索) には、すべての子オブジェクトと基本オブジェクトが含まれます。 LDAP プロバイダーに対して、他のディレクトリ doメイン やフォレストなど、他の LDAP ディレクトリ サービスへの紹介を追跡するように要求できます。