SysMsgProc 函式

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勾點類型和攔截程式的指標,來安裝攔截程式。

另請參閱

CallNextHookEx

味精

SetWindowsHookEx

勾點