DSBROWSEINFOA 구조체(dsclient.h)
DSBROWSEINFO 구조체는 DsBrowseForContainer 함수와 함께 사용하여 Active Directory 컨테이너 브라우저 대화 상자에 대한 데이터를 제공하고 반환합니다.
구문
typedef struct {
DWORD cbStruct;
HWND hwndOwner;
LPCSTR pszCaption;
LPCSTR pszTitle;
LPCWSTR pszRoot;
LPWSTR pszPath;
ULONG cchPath;
DWORD dwFlags;
BFFCALLBACK pfnCallback;
LPARAM lParam;
DWORD dwReturnFormat;
LPCWSTR pUserName;
LPCWSTR pPassword;
LPWSTR pszObjectClass;
ULONG cchObjectClass;
} DSBROWSEINFOA, *PDSBROWSEINFOA;
멤버
cbStruct
DSBROWSEINFO 구조체의 크기(바이트)를 포함합니다. 이는 버전 관리를 위해 DsBrowseForContainer 함수에서 사용됩니다.
hwndOwner
컨테이너 브라우저 대화 상자의 부모로 사용되는 창의 핸들입니다.
pszCaption
대화 상자의 캡션 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 이 멤버가 NULL인 경우 기본 캡션 사용됩니다.
pszTitle
트리 컨트롤 위의 대화 상자에 표시할 추가 텍스트가 포함된 null로 끝나는 문자열에 대한 포인터입니다. 이 멤버가 NULL이면 추가 텍스트가 표시되지 않습니다.
pszRoot
대화 상자의 루트에 배치된 컨테이너의 ADsPath를 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 사용자는 대화 상자를 사용하여 이 수준 이상으로 이동할 수 없습니다.
pszPath
대화 상자에서 선택한 컨테이너의 ADsPath를 수신하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. cchPath가 전체 경로를 보유할 만큼 크지 않더라도 이 문자열은 항상 null로 종료됩니다. dwFlags에 DSBI_EXPANDONOPEN 플래그가 포함된 경우 이 멤버는 대화 상자에서 처음에 선택해야 하는 컨테이너의 ADsPath를 포함합니다.
cchPath
pszPath 버퍼의 크기(WCHAR 문자)를 포함합니다.
dwFlags
대화 상자의 동작을 정의하는 플래그 집합을 포함합니다. 이 값은 0이거나 다음 값 중 하나 이상의 조합일 수 있습니다.
DSBI_NOBUTTONS(1(0x1))
+ 및 - 단추가 대화 상자에 표시되지 않습니다.
DSBI_NOLINES(2(0x2))
대화 상자에서 개체를 연결하는 줄이 표시되지 않습니다.
DSBI_NOLINESATROOT(4(0x4))
루트 개체 위의 선과 단추가 표시되지 않습니다.
DSBI_CHECKBOXES(256(0x100))
트리의 각 항목 옆에 검사 상자가 배치되도록 합니다. 사용자는 마우스를 사용하여 이 검사 상자를 선택하고 지울 수 있습니다. 항목의 검사 상태를 설정하거나 가져올 방법이 없으므로 현재 사용량이 제한되어 있습니다.
DSBI_NOROOT(65536(0x10000))
pszRoot로 지정된 루트 개체가 표시되지 않고 루트의 직속 자식 개체가 트리의 루트에 표시됩니다. pszRoot가 NULL이거나 이 멤버에 DSBI_ENTIREDIRECTORY 포함된 경우에는 이 플래그가 적용되지 않습니다.
DSBI_INCLUDEHIDDEN(131072(0x20000))
대화 상자에 숨겨진 개체를 포함합니다.
DSBI_EXPANDONOPEN(262144(0x40000))
대화 상자가 열리면 pszPath 에 지정된 컨테이너가 표시되고 선택됩니다.
DSBI_ENTIREDIRECTORY(589824(0x90000))
pszRoot 또는 기본적으로 사용자가 로그인한 도메인에 지정된 서버에 대한 모든 신뢰할 수 있는 도메인을 포함합니다.
DSBI_RETURN_FORMAT(1048576(0x100000))
dwReturnFormat 멤버가 유효하다는 것을 나타냅니다. 이 플래그가 설정되지 않은 경우 경로 형식은 기본적으로 X.500입니다.
DSBI_HASCREDENTIALS(2097152(0x200000))
pUserName 및 pPassword 는 액세스 자격 증명에 사용됩니다. 그렇지 않으면 이 멤버에 DSBI_SIMPLEAUTHENTICATE 포함되어 있지 않으면 대화 상자에서 호출 스레드의 보안 컨텍스트를 사용합니다.
DSBI_IGNORETREATASLEAF(4194304(0x400000))
개체가 대화 상자에 표시되는지 확인할 때 treatAsLeaf 표시 지정자는 무시됩니다.
DSBI_SIMPLEAUTHENTICATE(8388608(0x800000))
ADsOpenObject를 호출할 때 보안 인증이 필요하지 않음을 나타냅니다.
DSBI_RETURNOBJECTCLASS(16777216(0x1000000))
pszObjectClass 및 cchObjectClass가 유효하고 채워야 했음을 나타냅니다.
DSBI_DONTSIGNSEAL(33554432(0x2000000))
디렉터리 서비스와 통신할 때 서명 및 봉인이 사용되지 않음을 나타냅니다.
pfnCallback
컨테이너 브라우저 대화 상자에서 알림을 받는 애플리케이션 정의 BFFCallBack 콜백 함수에 대한 포인터입니다. 이 멤버를 사용하지 않는 경우 NULL 로 설정합니다.
lParam
pfnCallback에 대한 모든 호출에서 lpData 매개 변수로 전달된 애플리케이션 정의 32비트 값을 포함합니다. pfnCallback이 NULL인 경우 이 멤버는 무시됩니다.
dwReturnFormat
pszPath에서 반환된 ADSI 경로가 수락할 형식을 지정하는 ADS_FORMAT_ENUM 값 중 하나를 포함합니다.
pUserName
자격 증명에 사용되는 사용자 이름을 포함하는 유니코드 문자열에 대한 포인터입니다. dwFlags에 DSBI_HASCREDENTIALS 플래그가 설정되어 있지 않으면 이 멤버는 무시됩니다. 이 멤버가 NULL이면 현재 로그온한 사용자 이름이 사용됩니다.
pPassword
자격 증명에 사용되는 암호를 포함하는 유니코드 문자열에 대한 포인터입니다. dwFlags에 DSBI_HASCREDENTIALS 플래그가 설정되어 있지 않으면 이 멤버는 무시됩니다. 이 멤버가 NULL인 경우 현재 로그온한 사용자의 암호가 사용됩니다.
pszObjectClass
선택한 클래스 문자열을 수신하는 유니코드 문자열 버퍼에 대한 포인터입니다. dwFlags에 DSBI_RETURNOBJECTCLASS 플래그 집합이 없는 경우 이 멤버는 무시됩니다.
cchObjectClass
pszObjectClass 버퍼의 크기(WCHAR 문자)를 포함합니다.
설명
참고
dsclient.h 헤더는 DSBROWSEINFO를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 머리글 | dsclient.h |