如何获取CHM帮助文件的有效上下文ID？排查AfxMessageBox帮助调用失败问题

一、使用工具直接查看 #

• 微软HTML Help Workshop：官方原生工具，打开目标CHM文件后，通过「查看」菜单进入「HTML源」查看，或直接利用工具的「映射管理」功能，可直接看到上下文ID与对应页面的映射关系。它能解析CHM内部的.hhp（帮助项目文件）、.hhc（目录文件）等核心结构，这些内容用7-zip提取通常无法正确识别。
• 第三方CHM编辑器：比如CHM Editor，打开CHM后可直接查看内部的项目配置文件，找到[MAP]章节，里面会列出所有上下文ID到页面的映射，格式通常为ID=页面路径。
• Strings命令行工具：在CHM文件上执行strings your_help_file.chm，搜索包含数字ID+.htm或IDH_前缀的行，能快速定位到上下文ID与页面的对应字符串——CHM的映射表会以文本形式存储部分内容。

二、编程实现解析 #

C++方案 #

调用Windows原生HTML Help API，或直接解析CHM内部结构：

1. 使用HtmlHelp()函数结合枚举接口，遍历CHM中的上下文ID；
2. 直接读取CHM虚拟文件系统，找到内部的.hhp文件，解析其中[MAP]章节的内容，示例代码片段：

// 简化示例，需完善文件读取与解析逻辑
HANDLE hChm = CreateFile(L"your_help.chm", GENERIC_READ, FILE_SHARE_READ, NULL, OPEN_EXISTING, 0, NULL);
// 利用CHM内部文件枚举接口定位.hhp文件
// 读取文件内容后，提取[MAP]段，按行分割解析ID与页面映射

Python方案 #

使用pychm库读取CHM内部内容，解析映射关系：

import pychm

def parse_chm_context_ids(chm_path):
    chm = pychm.CHMFile(chm_path)
    for file_name in chm.files():
        if file_name.endswith('.hhp'):
            # 提取.hhp文件内容，旧CHM多使用GBK编码
            content = chm.extract(file_name).decode('gbk')
            if '[MAP]' in content:
                # 定位并提取[MAP]章节内容
                map_section = content.split('[MAP]')[1].split('[')[0].strip()
                for line in map_section.split('\n'):
                    line = line.strip()
                    if '=' in line:
                        id_part, page_path = line.split('=', 1)
                        print(f"上下文ID: {id_part.strip()}, 对应页面: {page_path.strip()}")

parse_chm_context_ids("your_help.chm")

C#方案 #

借助第三方库（如CHMReader）或调用Windows API读取CHM内部文件，解析.hhp中的[MAP]部分：

// 简化示例，需引用CHMReader库
var chmReader = new CHMReader("your_help.chm");
var hhpContent = chmReader.ExtractText("your_project.hhp");
var mapSection = hhpContent.Split(new[] { "[MAP]" }, StringSplitOptions.None)[1]
                          .Split(new[] { "[" }, StringSplitOptions.None)[0];
foreach (var line in mapSection.Split('\n'))
{
    var trimmedLine = line.Trim();
    if (trimmedLine.Contains('='))
    {
        var parts = trimmedLine.Split('=');
        Console.WriteLine($"上下文ID: {parts[0].Trim()}, 对应页面: {parts[1].Trim()}");
    }
}

针对你的场景补充提示 #

• 你提到的0x30000偏移是旧MFC程序常见的上下文ID处理方式，建议在找到的映射中同时查找135和196743（0x30000+135）对应的条目；
• 另一条路径使用196743有效，说明该ID确实存在映射，可先定位它对应的页面，再检查AfxMessageBox的调用参数是否完整（需确保传入MB_HELP标志，且应用程序已正确设置帮助文件路径）。

内容的提问来源于stack exchange，提问作者ROBERT RICHARDSON