DirectorySearcher.SearchRoot Propiedad

Definición

Espacio de nombres:

System.DirectoryServices

Ensamblado:

System.DirectoryServices.dll

Obtiene o establece un valor que indica el nodo de la jerarquía de Active Directory Domain Services donde se inicia la búsqueda.

public:
 property System::DirectoryServices::DirectoryEntry ^ SearchRoot { System::DirectoryServices::DirectoryEntry ^ get(); void set(System::DirectoryServices::DirectoryEntry ^ value); };

[System.DirectoryServices.DSDescription("DSSearchRoot")]
public System.DirectoryServices.DirectoryEntry SearchRoot { get; set; }

[<System.DirectoryServices.DSDescription("DSSearchRoot")>]
member this.SearchRoot : System.DirectoryServices.DirectoryEntry with get, set

Public Property SearchRoot As DirectoryEntry

Valor de propiedad

DirectoryEntry

Objeto DirectoryEntry en la jerarquía de Active Directory Domain Services donde se inicia 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 el servidor está usando 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 acceso de búsqueda como si usara LDAP. Por ejemplo, "GC://OU=..., DC=..., DC=...".

• El siguiente código de C# 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);