ISimpleFrameSite::P reMessageFilter メソッド (ocidl.h)

  • [アーティクル]

コントロール自体が処理を行う前に、コントロールのウィンドウで受信したメッセージを処理する機会をサイトに提供します。

構文

HRESULT PreMessageFilter(
  [in]  HWND    hWnd,
  [in]  UINT    msg,
  [in]  WPARAM  wp,
  [in]  LPARAM  lp,
  [out] LRESULT *plResult,
  [out] DWORD   *pdwCookie
);

パラメーター

[in] hWnd

メッセージを受信するコントロール ウィンドウのハンドル。

[in] msg

単純なフレーム サイトによって受信されたメッセージ。

[in] wp

メッセージの WPARAM 。

[in] lp

メッセージの LPARAM 。

[out] plResult

メッセージ処理の結果を受け取る変数へのポインター。

[out] pdwCookie

後で呼び出された場合に ISimpleFrameSite::P ostMessageFilter に渡される変数へのポインター。 このパラメーターには、このメソッドが S_OKを返す場合にのみ、割り当てられたデータを含める必要があります。そのため、割り当てを解放できる PostMessageFilter の呼び出しも受け取ります。 呼び出し元は、このパラメーターで返されるものに対して何の責任も負いません。

戻り値

このメソッドは、次の値を返すことができます。

リターン コード 説明
S_OK
 単純なフレーム サイトでは、このフィルターでメッセージが使用されないため、より多くの処理を行うことができます。
S_FALSE
 サイトがメッセージを処理しており、それ以上の処理は行われません。
E_NOTIMPL
 このサイトでは、PostMessageFilter を後で呼び出す必要がないことを示すメッセージ フィルター処理は行われません。
E_POINTER
 plResult または pdwCookie のアドレスが無効です。

注釈

正常な戻り値は、サイトがさらなる処理を許可するかどうかを示します。 S_OKはさらなる処理を示し、一方、S_FALSEはそれ以上処理しないことを意味する。 S_OKは、コントロールが後で PostMessageFilter を呼び出す必要があることを示します。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー ocidl.h

こちらもご覧ください

ISimpleFrameSite