DsBrowseForContainerA 함수(dsclient.h)
DsBrowseForContainer 함수는 Active Directory Domain Services 컨테이너 개체를 검색하는 데 사용되는 대화 상자를 표시합니다.
구문
int DsBrowseForContainerA(
[in] PDSBROWSEINFOA pInfo
);
매개 변수
[in] pInfo
컨테이너 브라우저 대화 상자 초기화에 대한 데이터를 포함하고 선택한 개체에 대한 데이터를 수신하는 DSBROWSEINFO 구조체에 대한 포인터입니다.
반환 값
함수는 다음 값 중 하나를 반환합니다.
설명
대화 상자에는 특정 루트의 컨테이너로 채워지거나 신뢰할 수 있는 도메인을 사용하는 컨테이너 선택기가 표시됩니다. 신뢰할 수 있는 도메인을 사용하는 경우 사용자가 현재 로그온한 도메인을 사용하거나 DSBROWSEINFO 구조의 pszRoot 멤버를 사용하여 애플리케이션에서 지정한 대체 도메인을 사용할 수 있습니다. 사용자가 확인 푸시버튼을 클릭하거나 개체를 두 번 클릭하면 IDOK 가 반환되고 pszPath 에 선택한 개체의 ADsPath가 포함됩니다. 사용자가 대화 상자를 취소하면 DsBrowseForContainer 는 IDCANCEL을 반환합니다.
pszRoot 멤버에는 다음 양식이 필요한 ADsPath가 포함되어 있습니다.
LDAP://fabrikam.com/CN=Users,DC=Fabrikam,DC=com
DsBrowseForContainer 는 이 경로를 트리의 루트로 사용합니다. pszRoot 멤버를 사용하여 사용자가 로그온한 도메인에 대한 트러스트가 있는 도메인을 지정하여 사용자가 대체 도메인의 사용자 컨테이너를 찾아볼 수 있도록 할 수도 있습니다. pszPath 멤버에 경로가 포함된 경우 대화 상자는 pszPath에서 지정한 개체에 도달할 때까지 pszRoot에서 컨테이너를 통해 이동합니다.
DsBrowseForContainer 함수는 DSBROWSEINFO 구조에 지정된 콜백 함수를 지원합니다. 콜백 함수를 사용하여 선택 변경에 따라 보기를 필터링, 수정 또는 업데이트할 수 있습니다. 자세한 내용은 BFFCallBack을 참조하세요.
예제
다음 코드 예제에서는 사용자가 로그온한 도메인의 컨테이너를 선택합니다. 또한 보기에는 모든 신뢰할 수 있는 도메인이 표시됩니다.
void PickContainer(void)
{
DSBROWSEINFOW dsbi = { 0 };
WCHAR wszResult[MAX_PATH];
dsbi.cbStruct = sizeof(dsbi);
dsbi.pszCaption = L"The container picker";
dsbi.pszTitle = L"Pick a container for this example.";
dsbi.pszPath = wszResult;
dsbi.cchPath = MAX_PATH;
dsbi.dwFlags = DSBI_ENTIREDIRECTORY;
int nReturn = DsBrowseForContainerW(&dsbi);
if ( IDOK == nReturn )
{
// wszResult contains the resulting path
}
}
참고
dsclient.h 헤더는 DsBrowseForContainer를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | dsclient.h |
| 라이브러리 | Dsuiext.lib |
| DLL | Dsuiext.dll |