DirectorySearcher.SearchRoot プロパティ

定義

検索を開始する 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; }
public System.DirectoryServices.DirectoryEntry? SearchRoot { get; set; }
[System.DirectoryServices.DSDescription("DSSearchRoot")]
public System.DirectoryServices.DirectoryEntry SearchRoot { get; set; }
member this.SearchRoot : System.DirectoryServices.DirectoryEntry with get, set
[<System.DirectoryServices.DSDescription("DSSearchRoot")>]
member this.SearchRoot : System.DirectoryServices.DirectoryEntry with get, set
Public Property SearchRoot As 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);  
    

適用対象