Поделиться через


DirectorySearcher.SearchRoot Свойство

Определение

Получает или задает значение, указывающее узел в иерархии доменных служб Active Directory, с которого начинается поиск.

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

Значение свойства

Объект DirectoryEntry в иерархии доменных служб Active Directory Domain, с которого начинается поиск. Значением по умолчанию является пустая ссылка (Nothing в Visual Basic).

Атрибуты

Комментарии

Если SearchRoot является пустой ссылкой (Nothing в Visual Basic), для корня поиска устанавливается корень домена, который используется сервером.

Существует несколько способов поиска в глобальном каталоге.

  • Перечислите глобальный каталог и выберите первый дочерний элемент.

  • Укажите имя сервера. Используйте функцию DsGetDcName для поиска глобального каталога. Дополнительные сведения о функции DsGetDcName см. в разделе DsGetDcName.

  • Получите RootDSE глобального каталога и запросите rootNamingContext.

  • Используйте глобальный каталог, указав путь поиска, как при использовании ПРОТОКОЛА LDAP. Например, "GC://OU=..., DC=..., DC=...".

  • В следующем коде C# показано, как перечислить глобальный каталог и выбрать первый дочерний элемент.

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

Применяется к