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이거나 다음 값 중 하나 이상의 조합일 수 있습니다. 예를 들어 dwStateMaskDSBS_HIDDEN 플래그 집합이 있고 dwStateDSBS_HIDDEN 플래그 집합이 없으면 항목이 표시됩니다. dwStateMaskDSBS_HIDDEN 플래그가 설정되지 않은 경우 dwStateDSBS_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 플래그를 설정하고, BFFCallBack0이 아닌 값을 반환하여 항목의 표시 이름을 변경할 수 있습니다.
szIconLocation[MAX_PATH]
항목에 대해 표시할 아이콘이 포함된 .exe, .dll또는 .ico 파일의 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 이는 ExtractIcon 함수에 전달할 수 있는 모든 파일 형식일 수 있습니다. 이 아이콘의 인덱스는 iIconResID지정됩니다. 항목에 대해 표시되는 아이콘을 수정하려면 아이콘 원본 파일 이름을 이 멤버에 복사하고, iIconResID 아이콘의 0부터 시작하는 인덱스로 설정하고, dwMask 멤버에서 DSBF_ICONLOCATION 플래그를 설정하고, BFFCallBack0이 아닌 값을 반환합니다.
iIconResID
항목에 대해 표시할 아이콘의 인덱스(0부터 시작하는 인덱스)를 포함합니다.
발언
메모
dsclient.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 DSBITEM을 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 헤더 | dsclient.h |
참고 항목
BFFCallBack
ExtractIcon