共用方式為


DispatchMessageW 函式 (winuser.h)

將訊息分派至視窗程式。 它通常用來分派由 getMessage 函式 擷取的訊息。

語法

LRESULT DispatchMessageW(
  [in] const MSG *lpMsg
);

參數

[in] lpMsg

類型:const MSG*

包含訊息之結構的指標。

傳回值

類型:LRESULT

傳回值會指定視窗程式所傳回的值。 雖然其意義取決於正在分派的訊息,但通常會忽略傳回值。

言論

MSG 結構必須包含有效的訊息值。 如果 lpmsg 參數指向 WM_TIMER 訊息,且 WM_TIMER 訊息的 lParam 參數不是 NULLlParam 指向呼叫的函式,而不是窗口程式。

請注意,應用程式負責擷取和分派輸入訊息至對話方塊。 大部分的應用程式都會為此使用主要訊息迴圈。 不過,若要允許使用者移至 並使用鍵盤來選取控件,應用程式必須呼叫 IsDialogMessage。 如需詳細資訊,請參閱 對話框鍵盤介面

例子

如需範例,請參閱 建立訊息循環

注意

winuser.h 標頭會將 DispatchMessage 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 winuser.h (包括 Windows.h)
連結庫 User32.lib
DLL User32.dll
API 集 ext-ms-win-ntuser-message-l1-1-0 (在 Windows 8 中引進)

另請參閱

概念

GetMessage

IsDialogMessage

MSG

訊息和消息佇列

PeekMessage

參考

TranslateMessage

WM_TIMER