DirectorySearcher.SearchRoot プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
検索を開始する 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);
適用対象
.NET