PostMessageA 函式 (winuser.h)

發行項
03/04/2024

Places (張貼) 訊息佇列中與建立指定視窗的線程相關聯的訊息，並傳回，而不等待線程處理訊息。

若要在與線程相關聯的消息佇列中張貼訊息，請使用 PostThreadMessage 函式。

語法

BOOL PostMessageA(
  [in, optional] HWND   hWnd,
  [in]           UINT   Msg,
  [in]           WPARAM wParam,
  [in]           LPARAM lParam
);

參數

[in, optional] hWnd

類型： HWND

視窗程式的句柄，其視窗程式是接收訊息。下列值具有特殊意義。

值	意義
HWND_BROADCAST ( (HWND) 0xffff)	訊息會張貼到系統中的所有最上層視窗，包括已停用或隱藏的未擁有視窗、重疊的視窗和彈出視窗。訊息不會張貼到子視窗。
NULL	函式的行為就像呼叫 PostThreadMessage ，而 dwThreadId 參數設定為目前線程的標識符。

從 Windows Vista 開始，郵件張貼受限於 UIPI。進程的線程只能將訊息張貼至進程較小或等於完整性層級之線程的訊息佇列。

[in] Msg

類型： UINT

要張貼的訊息。

如需系統提供的訊息清單，請參閱系統定義訊息。

[in] wParam

類型： WPARAM

其他特定訊息資訊。

[in] lParam

類型： LPARAM

其他特定訊息資訊。

傳回值

類型： BOOL

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

當 UIPI 封鎖訊息時，使用 GetLastError 擷取的最後一個錯誤會設定為 5 (拒絕存取) 。

訊息佇列中的訊息是透過呼叫 GetMessage 或 PeekMessage 函式來擷取。

需要使用 HWND_BROADCAST 進行通訊的應用程式應該使用 RegisterWindowMessage 函式來取得應用程式間通訊的唯一訊息。

系統只會對範圍 0 中的系統訊息進行封送處理， ( (WM_USER-1) ) 。若要將其他訊息傳送 (這些 >= WM_USER) 至另一個進程，您必須執行自定義封送處理。

如果您將 WM_USER下列範圍內的訊息傳送至異步訊息函式， (PostMessage、 SendNotifyMessage 和 SendMessageCallback) ，則其訊息參數不能包含指標。否則作業會失敗。函式會在接收線程有機會處理訊息之前傳回，而且傳送者會在使用訊息之前釋放記憶體。

請勿使用PostMessage張貼WM_QUIT訊息;使用 PostQuitMessage 函式。

輔助功能應用程式可以使用 PostMessage 將 WM_APPCOMMAND訊息張貼至殼層，以啟動應用程式。此功能不保證適用於其他類型的應用程式。

消息佇列最多可以包含 10,000 則訊息。此限制應該夠大。如果您的應用程式超過限制，應該重新設計以避免耗用太多系統資源。若要調整此限制，請修改下列登錄機碼。

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Windows NT
            CurrentVersion
               Windows
                  USERPostMessageLimit

如果函式失敗，請呼叫 GetLastError 以取得擴充的錯誤資訊。 GetLastError 會在達到限制時 傳回ERROR_NOT_ENOUGH_QUOTA 。

可接受的最小值為 4000。

範例

下列範例示範如何使用 PostMessage 函式張貼私人視窗訊息。假設您已定義名為 WM_COMPLETE 的私人視窗訊息：

#define        WM_COMPLETE     (WM_USER + 0)

您可以將訊息張貼至與建立指定視窗之線程相關聯的消息佇列，如下所示：

 WaitForSingleObject (pparams->hEvent, INFINITE) ;
 lTime = GetCurrentTime () ;
 PostMessage (pparams->hwnd, WM_COMPLETE, 0, lTime);

如需更多範例，請參閱起始數據連結。

注意

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

規格需求

需求	值
最低支援的用戶端	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)