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

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

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

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=...".

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