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을 반환합니다.

참고 이 메시지의 유니코드 버전 (DSBM_QUERYINSERTW)만 지원됩니다. DSBM_QUERYINSERTA 지원되지 않습니다.

 

[in] lParam

이 매개 변수의 값과 의미는 받은 알림에 의해 결정됩니다. 자세한 내용은 uMsg 매개 변수 아래의 알림 메시지 설명을 참조하세요.

[in] lpData

DsBrowseForContainer 함수에 전달된 DSBROWSEINFO 구조체에 대한 포인터를 포함합니다. 이는 모든 알림 메시지에 해당합니다.

반환 값

없음

설명

DSBM_* 메시지 값은 Dsclient.h에 정의되어 있습니다.

요구 사항

지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	shlobj_core.h

추가 정보

DSBITEM

DSBROWSEINFO

DsBrowseForContainer

SendMessage

WM_CONTEXTMENU

WM_HELP