다음을 통해 공유


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로 종료됩니다. dwFlagsDSBI_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))

pUserNamepPassword 액세스 자격 증명에 사용됩니다. 그렇지 않으면 이 멤버에 DSBI_SIMPLEAUTHENTICATE포함되어 있지 않으면 대화 상자에서 호출 스레드의 보안 컨텍스트를 사용합니다.

DSBI_IGNORETREATASLEAF(4194304(0x400000))

대화 상자에 개체가 표시되는지 확인할 때 처리AsLeaf 표시 지정자는 무시됩니다.

DSBI_SIMPLEAUTHENTICATE(8388608(0x800000))

ADsOpenObject호출할 때 보안 인증이 필요하지 않음을 나타냅니다.

DSBI_RETURNOBJECTCLASS(16777216(0x1000000))

pszObjectClasscchObjectClass 유효하며 채워야 임을 나타냅니다.

DSBI_DONTSIGNSEAL(33554432(0x2000000))

디렉터리 서비스와 통신할 때 서명 및 봉인이 사용되지 않음을 나타냅니다.

pfnCallback

컨테이너 브라우저 대화 상자에서 알림을 받는 애플리케이션 정의 BFFCallBack 콜백 함수에 대한 포인터입니다. 이 멤버를 사용하지 않으면 NULL 설정합니다.

lParam

pfnCallback대한 모든 호출에서 lpData 매개 변수로 전달되는 애플리케이션 정의 32비트 값을 포함합니다. pfnCallback NULL이 멤버는 무시됩니다.

dwReturnFormat

pszPath에서 반환된 ADSI 경로가 수락할 형식을 지정하는 ADS_FORMAT_ENUM 중 하나를 포함합니다.

pUserName

자격 증명에 사용되는 사용자 이름을 포함하는 유니코드 문자열에 대한 포인터입니다. dwFlagsDSBI_HASCREDENTIALS 플래그 집합이 없으면 이 멤버는 무시됩니다. 이 멤버가 NULL경우 현재 로그온한 사용자 이름이 사용됩니다.

pPassword

자격 증명에 사용되는 암호를 포함하는 유니코드 문자열에 대한 포인터입니다. dwFlagsDSBI_HASCREDENTIALS 플래그 집합이 없으면 이 멤버는 무시됩니다. 이 멤버가 NULL경우 현재 로그온한 사용자의 암호가 사용됩니다.

pszObjectClass

선택한 클래스 문자열을 수신하는 유니코드 문자열 버퍼에 대한 포인터입니다. dwFlagsDSBI_RETURNOBJECTCLASS 플래그 집합이 없으면 이 멤버는 무시됩니다.

cchObjectClass

pszObjectClass 버퍼의 크기(WCHAR 문자)를 포함합니다.

발언

메모

dsclient.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 DSBROWSEINFO를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

요구
지원되는 최소 클라이언트 Windows Vista
지원되는 최소 서버 Windows Server 2008
헤더 dsclient.h

참고 항목

ADS_FORMAT_ENUM

ADsOpenObject

BFFCallBack

DsBrowseForContainer