BFFCALLBACK

コールバック

シグネチャ

INT BFFCALLBACK(
    HWND hwnd,
    DWORD uMsg,
    LPARAM lParam,
    LPARAM lpData
);

パラメーター

フィールド	型	説明
hwnd	HWND	ブラウズダイアログボックスのウィンドウハンドルが格納されます。このハンドルは、SendMessage 関数を使用してブラウズダイアログボックスにメッセージを送信するために使用します。コンテナーブラウザーダイアログボックスは、次のメッセージを処理します。 BFFM_ENABLEOK このメッセージは、ダイアログボックスの OK コマンドボタンを有効または無効にします。このメッセージの wParam にはブール値が格納され、0 の場合は OK コマンドボタンを無効にします。wParam が 0 以外の場合は、OK コマンドボタンが有効になります。既定では、OK コマンドボタンは有効です。このメッセージの戻り値は使用されません。 BFFM_SETSELECTION このメッセージは、ダイアログボックス内の項目を選択します。このメッセージの lParam は、選択する項目の ADsPath を格納した TCHAR 文字列へのポインターです。このメッセージには ANSI 版と Unicode 版がありますが、どちらの版も Unicode 文字列へのポインターを受け取ります。このメッセージの戻り値は使用されません。
uMsg	DWORD	次のブラウズメッセージのいずれかを指定します。 BFFM_INITIALIZED この通知は、ダイアログボックスの初期化後に送信されます。 lParam は使用されません。この通知の戻り値は無視されます。 BFFM_SELCHANGED この通知は、ダイアログボックス内の選択が変更された後に送信されます。 lParam は、新しく選択された項目の ADsPath を格納した Unicode 文字列へのポインターです。この通知の戻り値は無視されます。 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 を返します。 Note このメッセージは Unicode 版の DSBM_QUERYINSERTW のみがサポートされます。DSBM_QUERYINSERTA はサポートされません。
lParam	LPARAM	このパラメーターの値と意味は、受け取った通知によって決まります。詳細については、uMsg パラメーターの説明にある各通知メッセージの記述を参照してください。
lpData	LPARAM	DsBrowseForContainer 関数に渡された DSBROWSEINFO 構造体へのポインターが格納されます。これはすべての通知メッセージに当てはまります。

公式ドキュメント

BFFCallBack 関数は、Active Directory ドメインサービスのコンテナーブラウザーダイアログボックスからイベント通知を受け取るアプリケーション定義のコールバック関数です。この関数へのポインターは、DsBrowseForContainer 関数を呼び出すときに、DSBROWSEINFO 構造体の pfnCallback メンバーでコンテナーブラウザーダイアログボックスに渡します。BFFCallBack は、アプリケーション定義の関数名のプレースホルダーです。

解説(Remarks)

DSBM_* メッセージの値は Dsclient.h で定義されています。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)