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

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

規格需求

最低支援的用戶端

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

最低支援的伺服器

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

標頭

 Winuser.h (包括 Windows.h)

另請參閱

參考

CallNextHookEx

SetWindowsHookExA/SetWindowsHookExW

概念

勾點