DSBITEMA 구조체(dsclient.h)

DSBITEM 구조에는 Active Directory 컨테이너 브라우저 대화 상자의 항목에 대한 데이터가 포함됩니다. 이 구조체는 DSBM_QUERYINSERT 알림과 함께 BFFCallBack 콜백 함수에 전달됩니다. 컨테이너 브라우저 대화 상자는 DsBrowseForContainer 함수를 사용하여 만들어집니다.

구문

typedef struct {
  DWORD   cbStruct;
  LPCWSTR pszADsPath;
  LPCWSTR pszClass;
  DWORD   dwMask;
  DWORD   dwState;
  DWORD   dwStateMask;
  CHAR    szDisplayName[DSB_MAX_DISPLAYNAME_CHARS];
  CHAR    szIconLocation[MAX_PATH];
  INT     iIconResID;
} DSBITEMA, *PDSBITEMA;

멤버

cbStruct

구조체의 크기(바이트)를 포함합니다.

pszADsPath

항목의 ADsPath를 포함하는 null로 종료된 유니코드 문자열에 대한 포인터입니다.

pszClass

항목의 개체 클래스 이름을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

dwMask

유효한 데이터를 포함하는 구조체의 멤버를 나타내는 플래그 집합을 포함합니다. 이 값은 0이거나 다음 값 중 하나 이상의 조합일 수 있습니다.

DSBF_DISPLAYNAME

szDisplayName 멤버에 유효한 데이터가 포함되어 있습니다.

DSBF_ICONLOCATION

szIconLocation 및 iIconResID 멤버에는 유효한 데이터가 포함됩니다.

DSBF_STATE

dwState 및 dwStateMask 멤버에는 유효한 데이터가 포함됩니다.

dwState

항목의 상태를 나타내는 플래그 집합을 포함합니다. 이 값은 0이거나 다음 값 중 하나 이상의 조합일 수 있습니다.

DSBS_CHECKED

이 플래그가 설정되면 항목이 선택됩니다. 그렇지 않으면 항목이 선택되지 않습니다. 이 플래그는 현재 지원되지 않습니다.

DSBS_HIDDEN

이 플래그를 설정하면 항목이 숨겨집니다. 그렇지 않으면 항목이 표시됩니다.

DSBS_ROOT

이 플래그가 설정되면 항목은 루트 항목입니다. 그렇지 않으면 항목이 루트 항목이 아닙니다.

dwStateMask

유효한 데이터를 포함하는 dwState 멤버의 플래그를 나타내는 플래그 집합을 포함합니다. 이 값은 0이거나 다음 값 중 하나 이상의 조합일 수 있습니다. 예를 들어 dwStateMask 에 DSBS_HIDDEN 플래그가 설정되어 있고 dwState 에 DSBS_HIDDEN 플래그가 설정되어 있지 않으면 항목이 표시됩니다. dwStateMask에 DSBS_HIDDEN 플래그가 설정되어 있지 않으면 dwState의 DSBS_HIDDEN 플래그를 무시해야 합니다.

DSBS_CHECKED

dwState 멤버의 DSBS_CHECKED 플래그에는 유효한 데이터가 포함됩니다.

DSBS_HIDDEN

dwState 멤버의 DSBS_HIDDEN 플래그에는 유효한 데이터가 포함됩니다.

DSBS_ROOT

dwState 멤버의 DSBS_ROOT 플래그에는 유효한 데이터가 포함됩니다.

szDisplayName[DSB_MAX_DISPLAYNAME_CHARS]

항목의 표시 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 새 표시 이름을 이 멤버에 복사하고, dwMask 멤버에서 DSBF_DISPLAYNAME 플래그를 설정하고, BFFCallBack에서 0이 아닌 값을 반환하여 항목의 표시 이름을 변경할 수 있습니다.

szIconLocation[MAX_PATH]

항목에 표시할 아이콘이 포함된 .exe, .dll 또는 .ico 파일의 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 이는 ExtractIcon 함수에 전달할 수 있는 모든 파일 형식일 수 있습니다. 이 아이콘의 인덱스는 iIconResID에 지정됩니다. 항목에 대해 표시된 아이콘을 수정하려면 아이콘 원본 파일 이름을 이 멤버에 복사하고, iIconResID를 아이콘의 0부터 시작하는 인덱스로 설정하고, dwMask 멤버에서 DSBF_ICONLOCATION 플래그를 설정하고, BFFCallBack에서 0이 아닌 값을 반환합니다.

iIconResID

항목에 표시할 아이콘의 인덱스(0부터 시작)를 포함합니다.

참고 아이콘의 리소스 식별자가 아닙니다.

 

설명

참고

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
머리글	dsclient.h

추가 정보

BFFCallBack

DsBrowseForContainer

ExtractIcon