DirectorySearcher.SearchRoot プロパティ

定義

名前空間:

System.DirectoryServices

アセンブリ:

System.DirectoryServices.dll

パッケージ:

System.DirectoryServices v8.0.0

ソース:

DirectorySearcher.cs

検索を開始する Active Directory ドメイン サービス階層のノードを示す値を取得または設定します。

public:
 property System::DirectoryServices::DirectoryEntry ^ SearchRoot { System::DirectoryServices::DirectoryEntry ^ get(); void set(System::DirectoryServices::DirectoryEntry ^ value); };

public System.DirectoryServices.DirectoryEntry? SearchRoot { get; set; }

member this.SearchRoot : System.DirectoryServices.DirectoryEntry with get, set

Public Property SearchRoot As DirectoryEntry

プロパティ値

DirectoryEntry

検索を開始する Active Directory ドメイン サービス階層の DirectoryEntry オブジェクト。 既定値は null 参照 (Visual Basic では Nothing) です。

注釈

が null 参照 (Nothing Visual Basic の場合) の場合SearchRoot、検索ルートはサーバーが現在使用しているドメインのルートに設定されます。

グローバル カタログで検索するには、いくつかの方法があります。

• グローバル カタログを列挙し、最初の子を選択します。

• サーバー名を指定します。 DsGetDcName 関数を使用して、グローバル カタログを検索します。 DsGetDcName 関数の詳細については、「 DsGetDcName」を参照してください。

• グローバル カタログの RootDSE を取得し、"rootNamingContext" を要求します。

• LDAP を使用するかのように検索パスを指定して、グローバル カタログを使用します。 たとえば、"GC://OU=...、DC=...、DC=..." などです。

• 次の C# コードは、グローバル カタログを列挙し、最初の子を選択する方法を示しています。

  DirectoryEntry entry = new DirectoryEntry("GC://forestname");  
  IEnumerator ie = entry.Children.GetEnumerator();  
  ie.MoveNext();  
  entry = (DirectoryEntry)ie.Current;  
  DirectorySearcher search = new DirectorySearcher(entry);