基本介紹
- 中文名：long BroadcastSystemMessage
- dwFlags：選項標誌
- Windows NT：4.0及以上版本
- Windows：95及以上版本
簡介,說明,
簡介
函式功能：該函式傳送訊息給指定的接受者。接受者可以是一個應用程式、安裝驅動器、網路驅動器、系統級設備驅動器或這些系統組件的組合。
函式原型：long BroadcastSystemMessage（DWORD dwFIags，LPDWORD IpdwRecipients,UINT UiMessage，WPARAMwParam,LPARAM IParam）；
參數：
dwFlags：選項標誌。可取下列值的組合：
BSF_FLUSHDISK：接受者處理訊息之後清洗磁碟。
BSF_FORCEIFHUNG：繼續廣播訊息，即使逾時周期結束或一個接受者已掛起。
BSF_IGNORECURRENTTASK：不傳送訊息給屬於當前任務的視窗。這樣，應用程式就不會接收自己的訊息。
BSF_NOHANG：強制掛起的應用程式逾時。如果一個接受者逾時，不再繼續廣播訊息。
BSF_NOTIMEOUTIFNOTHUNG：只要接受者沒掛起，一直等待對訊息的回響。不會出現逾時。
BSF_POSTMESSAGE：寄送訊息。不能和BSF_QUERY組合使用。
BSF_QUERY：每次傳送訊息給一個接受者，只有當前接受者返回TRUE後，才能傳送給下一個接受者。
lpdwRecipients：指向變數的指針，該變數含有和接收訊息接受者的信息。此變數可為下列值的組合：
說明
BSM_ALLCOMPONENTS：廣播到所有的系統組件。
BSM_ALLDESKTOPS：Windows NT下，廣播到所有的桌面。要求SE_TCB_NAME特權。
BSM_APPLICATIONS：廣播到應用程式。
BSM_INSTALLABLEDRIVERS：Windows 95下，廣播到安裝驅動器。
BSM_INTDRIVER：Windows 95下，廣播到網路驅動器。
BSM_VXDS：Windows 95下，廣播到所有系統級設備驅動器。
當函式返回時，此變數接受上述值的組合，以確定真正接受訊息的接受者。如果此參數為NULL，則將訊息廣播到所有的組件。
uiMessage：系統訊息標識符。
WParam：32位訊息特定值。
IParam：32位訊息特定值。
返回值:如果函式調用成功，返回值是正數。如果函式不能廣播訊息，返回值是C1。如果參數dwFlags為BSF_QUERY且至少一個接受者返回BROADCAST_QUERY_DENY給相應的訊息，返回值是零。若想獲得更多的錯誤信息，請調用GetLastError函式。
備註：如果BSF_QUERY沒指定，函式傳送指定的訊息給所有請求的接受者，並忽略這些接受者返回的值。
速查：Windows NT：4.0及以上版本：Windows：95及以上版本；Windows CE：不支持；頭檔案：winuser.h；輸入庫：user32.lib；Unicode：在Windows NT環境下以Unicode和ANSI方式實現。
