DirectorySearcher.SearchRoot Propiedad

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

Valor de propiedad

El objeto DirectoryEntry de la jerarquía de Servicios de dominio de Active Directory donde comienza la búsqueda. El valor predeterminado es una referencia nula (Nothing en Visual Basic).

Atributos

DSDescriptionAttribute

Comentarios

Si SearchRoot es una referencia nula (Nothing en Visual Basic), la raíz de búsqueda se establece en la raíz del dominio que usa el servidor actualmente.

Hay varias maneras de buscar en el catálogo global:

• Enumere el catálogo global y elija el primer elemento secundario.

• Especifique el nombre del servidor. Use la función DsGetDcName para buscar el catálogo global. Para obtener más información sobre la función DsGetDcName, vea DsGetDcName.

• Obtenga rootDSE del catálogo global y solicite "rootNamingContext".

• Use el catálogo global y especifique una ruta de búsqueda como si usara LDAP. Por ejemplo, "GC://OU=..., DC=..., DC=...".

• El código de C# siguiente muestra cómo enumerar el catálogo global y elegir el primer elemento secundario.

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

Se aplica a