SysMsgProc 函式

發行項
07/01/2023

Description

與SetWindowsHookExA/SetWindowsHookExW函式搭配使用的應用程式定義或程式庫定義回呼函式。系統會在輸入事件發生在對話方塊、訊息方塊、功能表或捲軸之後呼叫此函式，但在處理輸入事件所產生的訊息之前。函式可以監視系統中任何對話方塊、訊息方塊、功能表或捲軸的訊息。

HOOKPROC類型會定義這個回呼函式的指標。 SysMsgProc 是應用程式定義或程式庫定義函數名稱的預留位置。

LRESULT CALLBACK SysMsgProc(
  _In_ int    nCode,
       WPARAM wParam,
  _In_ LPARAM lParam
);

參數

nCode [in]

類型： int

產生訊息的輸入事件種類。

如果 nCode 小於零，攔截程式必須將訊息傳遞至 CallNextHookEx 函式，而不需進一步處理，而且應該傳回 CallNextHookEx傳回的值。

此參數可以是下列其中一個值。

值	意義
MSGF_DIALOGBOX 0	輸入事件發生在訊息方塊或對話方塊中。
MSGF_MENU 2	輸入事件發生在功能表中。
MSGF_SCROLLBAR 5	輸入事件發生在捲軸中。

wParam

類型： WPARAM

不使用這個參數。

lParam [in]

類型： LPARAM

MSG訊息結構的指標。

傳回

類型： LRESULT

如果 nCode 小於零，攔截程式必須傳回 CallNextHookEx傳回的值。

如果 nCode 大於或等於零，且攔截程式未處理訊息，強烈建議您呼叫 CallNextHookEx 並傳回傳回的值;否則，已安裝 WH_SYSMSGFILTER 勾點的其他應用程式將不會收到勾點通知，因此行為不正確。

如果攔截程式處理訊息，它可能會傳回非零值，以防止系統將訊息傳遞至目標視窗程式。

備註

應用程式會藉由在呼叫SetWindowsHookExA/SetWindowsHookExW函式中指定WH_SYSMSGFILTER勾點類型和攔截程式的指標，來安裝攔截程式。

另請參閱