RegisterWindowMessageA 函式 (winuser.h)

發行項
03/04/2024

定義保證在整個系統中是唯一的新視窗訊息。傳送或張貼訊息時，可以使用訊息值。

語法

UINT RegisterWindowMessageA(
  [in] LPCSTR lpString
);

參數

[in] lpString

類型： LPCTSTR

要註冊的訊息。

傳回值

類型： UINT

如果成功註冊訊息，則傳回值是範圍中的訊息標識碼，0xC000到0xFFFF。

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

備註

RegisterWindowMessage 函式通常用於註冊訊息，以在兩個作用中應用程式之間進行通訊。

如果兩個不同的應用程式註冊相同的訊息字串，則應用程式會傳回相同的訊息值。訊息會保持註冊狀態，直到會話結束為止。

只有在多個應用程式必須處理相同的訊息時，才使用 RegisterWindowMessage 。若要在窗口類別內傳送私人訊息，應用程式可以使用範圍中的任何整數，WM_USER 到0x7FFF。 (此範圍中的訊息是窗口類別的私人訊息，而不是應用程式。例如，按鈕、 EDIT、 LISTBOX 和 COMBOBOX 等預先定義的控件類別可能會使用此範圍中的值。)

範例

如需範例，請參閱尋找文字。

注意

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