ITfMessagePump::P eekMessageW メソッド (msctf.h)

  • [アーティクル]

メッセージ キューからメッセージを取得し、メッセージが取得されない場合は を返します。 これは、このメソッドの Unicode バージョンです。

構文

HRESULT PeekMessageW(
  [out] LPMSG pMsg,
  [in]  HWND  hwnd,
  [in]  UINT  wMsgFilterMin,
  [in]  UINT  wMsgFilterMax,
  [in]  UINT  wRemoveMsg,
  [out] BOOL  *pfResult
);

パラメーター

[out] pMsg

メッセージ データを受信する MSG 構造体へのポインター。

[in] hwnd

メッセージが取得されたウィンドウを処理します。 ウィンドウは現在のスレッドに属している必要があります。 この値が NULL の場合、このメソッドは呼び出し元のスレッドに属するすべてのウィンドウのメッセージを取得します。

[in] wMsgFilterMin

取得するメッセージの最小値を指定します。

[in] wMsgFilterMax

取得するメッセージ値の最大値を指定します。

[in] wRemoveMsg

メッセージの処理方法を指定します。 詳細については、「 PeekMessage 関数」を参照してください。

[out] pfResult

PeekMessage 関数から戻り値を受け取る BOOL へのポインター。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

値 説明
S_OK
 メソッドは正常に実行されました。
E_INVALIDARG
 1 つ以上のパラメーターが無効です。

解説

wMsgFilterMin と wMsgFilterMax の両方が 0 の場合、このメソッドは使用可能なすべてのメッセージを返します。つまり、範囲フィルター処理は実行されません。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー msctf.h
[DLL] Msctf.dll
再頒布可能パッケージ Windows 2000 Professional 上の TSF 1.0

関連項目

ITfMessagePump

Msg

PeekMessage