Freigeben über


DirectorySearcher.SearchRoot Eigenschaft

Definition

Ruft einen Wert ab, der den Knoten in der Active Directory-Domänendienste-Hierarchie angibt, bei dem die Suche beginnt, oder legt diesen fest.

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

Eigenschaftswert

Das DirectoryEntry-Objekt in der Active Directory-Domänendienste-Hierarchie, an dem die Suche begonnen wird. Der Standardwert ist ein NULL-Verweis (Nothing in Visual Basic).

Attribute

Hinweise

Wenn SearchRoot ein NULL-Verweis (Nothing in Visual Basic) ist, wird der Suchstamm auf den Stamm der Domäne festgelegt, die ihr Server derzeit verwendet.

Es gibt mehrere Möglichkeiten, im globalen Katalog zu suchen:

  • Auflisten Sie den globalen Katalog, und wählen Sie das erste untergeordnete Element aus.

  • Geben Sie den Servernamen an. Verwenden Sie die DsGetDcName-Funktion, um den globalen Katalog zu suchen. Weitere Informationen zur DsGetDcName-Funktion finden Sie unter DsGetDcName.

  • Rufen Sie den RootDSE des globalen Katalogs ab, und fragen Sie nach "rootNamingContext".

  • Verwenden Sie den globalen Katalog, und geben Sie einen Suchpfad an, als ob sie LDAP verwenden würden. Beispiel: "GC://OU=..., DC=..., DC=...".

  • Der folgende C#-Code zeigt, wie Sie den globalen Katalog auflisten und das erste untergeordnete Element auswählen.

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

Gilt für: