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
このメッセージは、ダイアログ ボックスの [OK] コマンド ボタンを有効または無効にします。
このメッセージの wParam には、0 の場合は [OK] コマンド ボタンを無効にするブール値が含まれています。 wParam が 0 以外の場合は、[OK] コマンド ボタンが有効になります。 既定では、[ OK] コマンド ボタンが有効になっています。
このメッセージの戻り値は使用されません。
BFFM_SETSELECTION
このメッセージは、ダイアログ ボックス内の項目を選択します。
このメッセージの lParam は、選択する項目の ADsPath を含む TCHAR 文字列へのポインターです。 このメッセージには ANSI バージョンと Unicode バージョンがありますが、どちらのバージョンも Unicode 文字列へのポインターを受け取ります。
このメッセージの戻り値は使用されません。
[in] uMsg
次のいずれかの参照メッセージを指定します。
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 を返します。
[in] lParam
このパラメーターの値と意味は、受信した通知によって決まります。 詳細については、 uMsg パラメーターの下の通知メッセージの説明を参照してください。
[in] lpData
DsBrowseForContainer 関数に渡される DSBROWSEINFO 構造体へのポインターを格納します。 これは、すべての通知メッセージに当てはまります。
戻り値
なし
解説
DSBM_* メッセージ値は Dsclient.h で定義されています。
要件
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | shlobj_core.h |