Udostępnij za pośrednictwem


DirectorySearcher.SearchRoot Właściwość

Definicja

Pobiera lub ustawia wartość wskazującą węzeł w hierarchii Active Directory Domain Services, w której rozpoczyna się wyszukiwanie.

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

Wartość właściwości

DirectoryEntry Obiekt w hierarchii Active Directory Domain Services, w której rozpoczyna się wyszukiwanie. Wartość domyślna to odwołanie o wartości null (Nothing w Visual Basic).

Atrybuty

Uwagi

Jeśli SearchRoot jest odwołaniem o wartości null (Nothing w Visual Basic), katalog główny wyszukiwania jest ustawiony na katalog główny domeny, z którą aktualnie korzysta serwer.

Istnieje kilka sposobów wyszukiwania w wykazie globalnym:

  • Wyliczenie wykazu globalnego i wybranie pierwszego elementu podrzędnego.

  • Określ nazwę serwera. Użyj funkcji DsGetDcName, aby znaleźć wykaz globalny. Aby uzyskać więcej informacji na temat funkcji DsGetDcName, zobacz DsGetDcName.

  • Pobierz element RootDSE wykazu globalnego i poproś o "rootNamingContext".

  • Użyj wykazu globalnego, określając ścieżkę wyszukiwania tak, jakby używała protokołu LDAP. Na przykład "GC://OU=..., DC=..., DC=...".

  • Poniższy kod w języku C# pokazuje, jak wyliczyć wykaz globalny i wybrać pierwsze dziecko.

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

Dotyczy