DirectorySearcher.SearchRoot Propiedad

Definición

Espacio de nombres:

System.DirectoryServices

Ensamblado:

System.DirectoryServices.dll

Paquete:

System.DirectoryServices v8.0.0

Source:

DirectorySearcher.cs

Obtiene o establece un valor que indica el nodo de la jerarquía de los Servicios de dominio de Active Directory donde comienza la búsqueda.

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

public System.DirectoryServices.DirectoryEntry? SearchRoot { get; set; }

member this.SearchRoot : System.DirectoryServices.DirectoryEntry with get, set

Public Property SearchRoot As DirectoryEntry

Valor de propiedad

DirectoryEntry

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).

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);