SendMessageTimeoutA 函式 (winuser.h)

發行項
08/28/2023

將指定的訊息傳送至一或多個視窗。

語法

LRESULT SendMessageTimeoutA(
  [in]            HWND       hWnd,
  [in]            UINT       Msg,
  [in]            WPARAM     wParam,
  [in]            LPARAM     lParam,
  [in]            UINT       fuFlags,
  [in]            UINT       uTimeout,
  [out, optional] PDWORD_PTR lpdwResult
);

參數

[in] hWnd

類型： HWND

視窗程式的控制碼會接收訊息。

如果此參數 HWND_BROADCAST ( (HWND) 0xffff) ，訊息就會傳送至系統中的所有最上層視窗，包括已停用或隱藏的未擁有視窗。函式不會傳回，直到每個視窗逾時為止。因此，等候時間總計最多可以乘以最上層視窗數目的 uTimeout 值。

[in] Msg

類型： UINT

要傳送的訊息。

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

[in] wParam

類型： WPARAM

任何其他訊息特定資訊。

[in] lParam

類型： LPARAM

任何其他訊息特定資訊。

[in] fuFlags

類型： UINT

此函式的行為。此參數可以是下列一或多個值。

值	意義
SMTO_ABORTIFHUNG 0x0002	如果接收執行緒似乎沒有回應或「停止回應」，函式會傳回而不等待逾時期間過後。
SMTO_BLOCK 0x0001	防止呼叫執行緒任何其他要求，直到函式傳回為止。
SMTO_NORMAL 0x0000	在等候函式傳回時，不會防止呼叫執行緒其他要求。
SMTO_NOTIMEOUTIFNOTHUNG 0x0008	只要接收執行緒正在處理訊息，函式就不會強制執行逾時期間。
SMTO_ERRORONEXIT 0x0020	如果接收視窗已終結，或在處理訊息時，其擁有線程會損毀，則函式應該會傳回 0。

[in] uTimeout

類型： UINT

逾時期間的持續時間，以毫秒為單位。如果訊息是廣播訊息，則每個視窗都可以使用完整逾時期間。例如，如果您指定五秒逾時期間，而且有三個無法處理訊息的最上層視窗，則最多可能會有 15 秒的延遲。

[out, optional] lpdwResult

類型： PDWORD_PTR

訊息處理的結果。此參數的值取決於指定的訊息。

傳回值

類型： LRESULT

如果函式成功，則傳回非零的值。如果使用HWND_BROADCAST，SendMessageTimeout不會提供個別視窗逾時的相關資訊。

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

Windows 2000： 如果 GetLastError 傳回 0，則函式逾時。

備註

函式會呼叫指定視窗的視窗程式，如果指定的視窗屬於不同的執行緒，則不會傳回，直到視窗程式處理訊息或經過指定的逾時期間為止。如果接收訊息的視窗屬於與目前線程相同的佇列，則會直接呼叫視窗程式—會忽略逾時值。

如果執行緒未在五秒內呼叫 GetMessage 或類似的函式，此函式就會認為執行緒沒有回應。

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

注意

winuser.h 標頭會根據 UNICODE 預處理器常數的定義，將 SendMessageTimeout 定義為別名，自動選取此函式的 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)