DirectorySearcher.SearchRoot 속성

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

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

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

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

속성 값

검색이 시작되는 Active Directory Domain Services 계층 구조의 DirectoryEntry 개체입니다. 기본값은 null 참조(Nothing Visual Basic의 경우)입니다.

특성

DSDescriptionAttribute

설명

SearchRoot null 참조(Visual Basic Nothing)인 경우 검색 루트는 서버에서 현재 사용 중인 도메인의 루트로 설정됩니다.

글로벌 카탈로그에서 검색하는 방법에는 여러 가지가 있습니다.

• 글로벌 카탈로그를 열거하고 첫 번째 자식 을 선택합니다.

• 서버 이름을 지정합니다. 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);