SendMessageCallback

SendMessageCallback是一個計算機函式，能將指定的訊息傳送到一個或多個視窗，此函式為指定的視窗調用視窗程式，並立即返回；當視窗程式處理完訊息後，系統調用指定的回調函式，將訊息處理的結果和一個應用程式定義的值傳給回調函式。

基本介紹

• 外文名：SendMessageCallback
• 功能：將指定的訊息傳送到多個視窗
• 原型：BOOL SendMessageCallback
• 類別：計算機函式

函式原型

BOOL SendMessageCallback（HWND hwnd，UINT Msg，WPARAM wParam，LPARAM IParam，

SEhDASYNCPROC IpResultCallBack，DWORD dwData）；

參數

hWnd：其視窗程式將接收訊息的視窗的句柄。如果此參數為HWND_BROADCAST，則訊息將被傳送到系統中所有頂層視窗，包括無效或不可見的非自身擁有的視窗、被覆蓋的視窗和彈出式視窗，但訊息不被傳送到子視窗。

Msg：指定被傳送的訊息。

wParam：指定附加的訊息指定信息。

IParam：指定附加的訊息指定信息。

IpResultCallBack：指向回收函式的指針，視窗程式處理完訊息後調用該回調函式。參見SendAsyncProc可得到合適的回調函式的信息。如果hwnd為HWND_BROADCAST，系統為每個頂層視窗調用一次SendASyncProc回調函式。

dwData：一個應用程式定義的值，被傳給由參數IPResultCallBack指向的回調函式。

返回值

如果函式調用成功，返回非零值。如果函式調用失敗，返回值是零。若想獲得更多的錯誤信息，請調用GetLastError函式。

備註

如果傳送一個低於WM_USER範圍的訊息給異步訊息函式（PostMessage，SendNotifyMesssge；SendMessageCallback），訊息參數不能包含指針。否則，操作將會失敗。函式將在接收執行緒處理訊息之前返回，傳送者將在記憶體被使用之前釋放。

需要以HWND_BROADCAST方式通信的應用程式應當用函式RegisterWindwosMessage來獲得應用程式間通信的獨特的訊息。

此回調函式僅當調用SendMessagecallback的執行緒調用GetMessage，PeekMessage或WaitMessage時調用。

速查

Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：不支持；頭檔案：winuser.h；輸入庫：user32.lib；Unicode：在Windows NT環境下以Unicode和ANSI方式實現。