Visual Studio 2013 如何使用TitanEngine引擎库调试

优质创作者: 编程框架技术领域

领域专家: 操作系统技术领域

2026-06-30 13:14:43

前文已详细讲解泰坦引擎的编译生成方法，本章将进阶实操泰坦引擎应用开发，聚焦零基础实现C++调用泰坦引擎、进程附加分析核心能力。本文基于静态链接库模式编译生成的TitanEngine.lib库，搭配官方TitanEngine.h头文件完成环境配置，以打印PE节表信息为实战案例，手把手讲解C++接入泰坦引擎、实现简单进程附加分析的完整流程，补齐泰坦引擎从编译搭建到功能落地的实操教程，帮助开发者快速掌握引擎调用与基础逆向分析技巧。

使用静态链接库模式编译泰坦引擎，然后会生成TitanEngine.lib库，此时下载TitanEngine-2025.08.18.zip文件，并提取出内部的TitanEngine.h文件，将其直接放入到我们自定义的文件夹内，这里的文件夹如下所示。

打开Visual Studio 2013 新建控制台项目，并引入头文件及库文件。

接着在代码生成部分，修改运行库为多线程MT模式，保存。

导入泰坦引擎，并使用如下代码测试

#include <iostream>
#include <cstring>
#include <windows.h>
#include <TitanEngine.h>

#pragma comment(lib,"TitanEngine.lib")
#pragma comment(lib, "ntdll.lib")
#pragma comment(lib, "psapi.lib")
#pragma comment(lib, "dbghelp.lib")
#pragma comment(lib, "kernel32.lib")
#pragma comment(lib, "user32.lib")
#pragma comment(lib, "advapi32.lib")
#pragma comment(lib, "distorm.lib")

// OEP入口断点标准回调
void __stdcall OEP_Callback()
{
    printf("==================== 命中程序原始入口OEP ====================\n");

    ULONG_PTR entryRipEip = GetContextData(UE_CIP);
    ULONG_PTR eax = GetContextData(UE_EAX);
    ULONG_PTR ebx = GetContextData(UE_EBX);
    ULONG_PTR ecx = GetContextData(UE_ECX);
    ULONG_PTR edx = GetContextData(UE_EDX);
    printf("EAX=0x%08X | EBX=0x%08X | ECX=0x%08X | EDX=0x%08X\n", eax, ebx, ecx, edx);

    const char* disasmText = (const char*)Disassemble((LPVOID)entryRipEip);
    printf("入口指令：%s\n\n", disasmText);

    // 获取进程信息结构体
    PROCESS_INFORMATION* procInfo = (PROCESS_INFORMATION*)TitanGetProcessInformation();

    // 静态读取镜像基址
    const char targetExe[] = R"(e://win32.exe)";
    ULONG_PTR moduleBase = GetPE32Data(targetExe, 0, UE_IMAGEBASE);
    printf("进程句柄: %p 模块基址:0x%08X\n", procInfo->hProcess, moduleBase);

    // 读取入口附近内存
    unsigned char buf[16] = { 0 };
    SIZE_T readLen = 0;
    bool readOk = MemoryReadSafe(procInfo->hProcess, (LPVOID)entryRipEip, buf, 16, &readLen);
    if (readOk)
    {
        printf("入口附近16字节: ");
        for (int i = 0; i < 16; i++)
            printf("%02X ", buf[i]);
        printf("\n");
    }

    printf("\n分析完成，停止调试\n");
    StopDebug();
}

// 静态读取并打印PE基础信息
void PrintPEInfo(const char* filePath)
{
    printf("========= 读取PE基础信息 =========\n");
    ULONG_PTR imageBase = GetPE32Data(filePath, 0, UE_IMAGEBASE);
    ULONG_PTR oepRva = GetPE32Data(filePath, 0, UE_OEP);
    ULONG_PTR sizeImage = GetPE32Data(filePath, 0, UE_SIZEOFIMAGE);
    ULONG sectionCount = GetPE32Data(filePath, 0, UE_SECTIONNUMBER);
    ULONG checkSum = GetPE32Data(filePath, 0, UE_CHECKSUM);

    printf("镜像基址 ImageBase: 0x%08X\n", imageBase);
    printf("原始入口RVA OEP: 0x%08X  真实入口VA:0x%08X\n", oepRva, imageBase + oepRva);
    printf("镜像总大小 SizeOfImage: 0x%08X\n", sizeImage);
    printf("节区数量 SectionCount: %lu\n", sectionCount);
    printf("PE头校验和 CheckSum: 0x%08X\n\n");
}

// 打印全部节表信息
void PrintAllSections(const char* filePath)
{
    printf("==================== PE 全部节表信息 ====================\n");
    // 获取节总数
    ULONG sectionTotal = (ULONG)GetPE32Data(filePath, 0, UE_SECTIONNUMBER);
    if (sectionTotal == 0)
    {
        printf("未读取到任何节信息！\n");
        return;
    }
    printf("节总数：%u\n\n", sectionTotal);
    printf("节名\t虚拟偏移RVA\t虚拟大小\t文件偏移\t原始大小\t节标志(0x)\n");
    printf("------------------------------------------------------------------------\n");

    // 循环读取每一节信息
    for (DWORD i = 0; i < sectionTotal; i++)
    {
        // 节名称（字符串指针）
        char* szSecName = (char*)GetPE32Data(filePath, i, UE_SECTIONNAME);
        // 虚拟偏移 RVA
        ULONG_PTR secRva = GetPE32Data(filePath, i, UE_SECTIONVIRTUALOFFSET);
        // 虚拟大小
        ULONG_PTR secVirSize = GetPE32Data(filePath, i, UE_SECTIONVIRTUALSIZE);
        // 文件原始偏移
        ULONG_PTR secRawOff = GetPE32Data(filePath, i, UE_SECTIONRAWOFFSET);
        // 文件原始大小
        ULONG_PTR secRawSize = GetPE32Data(filePath, i, UE_SECTIONRAWSIZE);
        // 节权限标志
        ULONG_PTR secFlags = GetPE32Data(filePath, i, UE_SECTIONFLAGS);

        printf("%-8s\t0x%08llX\t0x%08llX\t0x%08llX\t0x%08llX\t0x%08llX\n",
            szSecName, secRva, secVirSize, secRawOff, secRawSize, secFlags);
    }
    printf("========================================================================\n\n");
}

int main()
{
    const char targetExe[] = R"(e://win32.exe)";

    // 关闭PE加载弹窗报错
    SetErrorModel(FALSE);

    PrintPEInfo(targetExe);
    PrintAllSections(targetExe);

    LPVOID procInfoRaw = InitDebugEx(targetExe, "", ".", OEP_Callback);
    if (procInfoRaw == nullptr)
    {
        printf("错误：InitDebugEx 创建调试进程失败！\n");
        system("pause");
        return -1;
    }

    printf("调试进程创建成功，等待执行至入口点...\n");

    // 阻塞调试主循环
    DebugLoop();

    printf("\n全部分析流程结束\n");
    system("pause");
    return 0;
}