DispatchMessage 函式 (winuser.h)

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

語法

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

[in] lpMsg

類型： const MSG*

包含訊息之結構的指標。

類型： LRESULT

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

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

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

如需範例，請參閱建立訊息迴圈。

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	winuser.h (包括 Windows.h)
程式庫	User32.lib
Dll	User32.dll
API 集合	ext-ms-win-ntuser-message-l1-1-0 (於 Windows 8) 中引進