共用方式為


ForegroundIdleProc 回呼函式

SetWindowsHookExA/SetWindowsHookExW函式搭配使用的應用程式定義或程式庫定義回呼函式。 每當前景執行緒即將變成閒置時,系統就會呼叫此函式。

語法

DWORD CALLBACK ForegroundIdleProc(
  _In_ int   code,
       DWORD wParam,
       LONG  lParam
);

參數

  • 程式碼 [in]
    類型: int

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

  • wParam
    類型: DWORD

    不使用這個參數。

  • lParam
    類型: LONG

    不使用這個參數。

傳回值

類型:****

類型:DWORD

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

如果 程式碼 大於或等於零,強烈建議您呼叫 CallNextHookEx 並傳回其傳回的值;否則,已安裝 WH_FOREGROUNDIDLE 勾點的其他應用程式將不會收到勾點通知,因此的行為可能會不正確。 如果攔截程式未呼叫 CallNextHookEx,則傳回值應該是零。

備註

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

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

處理此回呼函式時,請避免呼叫任何從呼叫執行緒訊息佇列擷取視窗訊息的函式。 這包括GetMessagePeekMessageA/PeekMessageW、強制回應對話方塊和 COM 函式。 當呼叫執行緒的訊息佇列中有訊息時,呼叫這類函式可能會導致執行緒未從 GetMessageWaitMessage 傳回。

規格需求

最低支援的用戶端

Windows 2000 Professional [僅限傳統型應用程式]

最低支援的伺服器

Windows 2000 Server [僅限桌面應用程式]

標頭

Winuser.h (包括 Windows.h)

另請參閱

參考

CallNextHookEx

SetWindowsHookExA/SetWindowsHookExW

概念

勾點