BFFCALLBACK 콜백 함수(shlobj_core.h)
BFFCallBack 함수는 Active Directory Domain Services 컨테이너 브라우저 대화 상자에서 이벤트 알림을 수신하는 애플리케이션 정의 콜백 함수입니다. 이 함수에 대한 포인터는 DsBrowseForContainer 함수가 호출되면 DSBROWSEINFO 구조체의 pfnCallback 멤버에 있는 컨테이너 브라우저 대화 상자에 제공됩니다. BFFCallBack 은 애플리케이션 정의 함수 이름의 자리 표시자입니다.
구문
BFFCALLBACK Bffcallback;
int Bffcallback(
[in] HWND hwnd,
[in] UINT uMsg,
[in] LPARAM lParam,
[in] LPARAM lpData
)
{...}
매개 변수
[in] hwnd
찾아보기 대화 상자의 창 핸들을 포함합니다. 이 핸들은 SendMessage 함수를 사용하여 찾아보기 대화 상자로 메시지를 보내는 데 사용됩니다.
컨테이너 브라우저 대화 상자는 다음 메시지를 처리합니다.
BFFM_ENABLEOK
이 메시지는 대화 상자에서 확인 명령 단추를 사용하거나 사용하지 않도록 설정합니다.
이 메시지의 wParam 에는 0이면 확인 명령 단추를 사용하지 않도록 설정하는 부울 값이 포함되어 있습니다. wParam이 0이 아닌 경우 확인 명령 단추가 사용하도록 설정됩니다. 기본적으로 확인 명령 단추는 사용하도록 설정됩니다.
이 메시지의 반환 값은 사용되지 않습니다.
BFFM_SETSELECTION
이 메시지는 대화 상자에서 항목을 선택합니다.
이 메시지의 lParam 은 선택할 항목의 ADsPath를 포함하는 TCHAR 문자열에 대한 포인터입니다. 이 메시지의 ANSI 및 유니코드 버전이 있더라도 두 버전 모두 유니코드 문자열에 대한 포인터를 사용합니다.
이 메시지의 반환 값은 사용되지 않습니다.
[in] uMsg
다음 찾아보기 메시지 중 하나를 지정합니다.
BFFM_INITIALIZED
이 알림은 대화 상자가 초기화된 후에 전송됩니다.
lParam 은 사용되지 않습니다.
이 알림의 반환 값은 무시됩니다.
BFFM_SELCHANGED
이 알림은 대화 상자의 선택 항목이 변경된 후에 전송됩니다.
lParam 은 새로 선택한 항목의 ADsPath를 포함하는 유니코드 문자열에 대한 포인터입니다.
이 알림의 반환 값은 무시됩니다.
DSBM_CHANGEIMAGESTATE
예약되어 있습니다.
DSBM_CONTEXTMENU
이 알림은 대화 상자가 WM_CONTEXTMENU 메시지를 받을 때 전송됩니다.
lParam은 WM_CONTEXTMENU 메시지와 함께 전달된 wParam 값입니다.
이 알림의 반환 값은 무시됩니다.
DSBM_HELP
이 알림은 대화 상자에서 WM_HELP 메시지를 받으면 전송됩니다.
lParam은 WM_HELP 메시지와 함께 전달된 lParam 값입니다.
이 알림의 반환 값은 무시됩니다.
DSBM_QUERYINSERT
이 알림은 각 컨테이너 개체가 트리에 삽입되기 전에 전송됩니다. 애플리케이션은 이 알림을 사용하여 대화 상자의 내용을 수정할 수 있습니다.
lParam 은 삽입된 항목에 대한 데이터를 포함하는 DSBITEM 구조체에 대한 포인터입니다. szDisplayName과 같은 이 구조체의 일부 멤버는 이 알림 중에 수정하여 항목이 표시되는 방식을 변경할 수 있습니다.
DSBITEM 구조체의 데이터가 변경되면 이 알림에서 0이 아닌 값을 반환합니다. 시간을 변경하지 않고 삽입해야 하는 경우 0을 반환합니다.
[in] lParam
이 매개 변수의 값과 의미는 받은 알림에 의해 결정됩니다. 자세한 내용은 uMsg 매개 변수 아래의 알림 메시지 설명을 참조하세요.
[in] lpData
DsBrowseForContainer 함수에 전달된 DSBROWSEINFO 구조체에 대한 포인터를 포함합니다. 이는 모든 알림 메시지에 해당합니다.
반환 값
없음
설명
DSBM_* 메시지 값은 Dsclient.h에 정의되어 있습니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | shlobj_core.h |