介绍一个专门处理C++异常的类和例子

    下载源代码和例子

    简介：

    CExceptionLogger，是一个可以免费使用的C++类，用它可以截获未处理异常，如：非法存取、栈溢出、被零除等，并可以将异常详细信息记录到日志文件。这个类源自于MSDN Magazine 2002年3月的一篇专栏文章“Under the Hood: Improved Error Reporting with DBGHELP 5.1”，该文章的作者是 Matt Pietrek。

    特性：

    在默认情况下，CExceptionLogger产生一个日志文件，名字为：nameofexe.exception，这里的nameofexe是exe文件的名字。如果以ASCII模式生成CExceptionLogger，则日志文件为一ASCII文件；如果以UNICODE模式生成CExceptionLogger，那么日志文件为一UNICODE文件。日志文件记录的信息包括：
    记录异常发生的日期和时间。
    异常代码。
    如果发生非法存取，则记录该异常的详细信息。
    记录的异常详细信息包括：线性地址、段、偏移量和模块路径。
    进程的全路径名。
    当前Win32工作目录。
    进程的命令行。
    进程ID。
    发生异常的线程ID。
    列举进程中所有的线程（假设ToolHelp32是可获得的），内容包括：
    线程ID
    优先级和Delta优先级
    参考
    创建时间
    Kernel 和 User Time
    列举进程中的模块（同样假设ToolHelp32是可获得的），内容包括：
    名字和全路径
    全程及每个进程的引用计数
    模块句柄
    大小
    模块完全展开后的所有符号
    所有x86寄存器。
    异常发生的调用堆栈，包括：段、偏移量、模块、函数和行信息。
    日志文件记录的内容还包括每一个堆栈帧（stack frame）以及所有模块、所有变量、所有参数；所有基本数据类型，如：voids, chars, shorts, Words, ints, DWORDS, floats, doubles 和 longs。此外日志还记录用户定义的数据类型（UDT）包括结构、联合以及类的信息，再现其成员数据。每种类型都包括名字、地址、类型和值。如果变量是一数组，该数组中的值被完全记录。

    版权声明：
    你可以在任何以二进制形式发布的产品（包括商业的、共享的、自由的或其它的）中包含此源代码
    在不修改每个模块（*.h、*.cpp）最上方版权细则的前提下，你可以用任何方式修改源代码
    如果你想要与自己的应用程序一起分发源代码，只允许分发作者最新发布的版本，以便保证源代码的出处是唯一的
    使用方法：
    编译这个类需要安装2002年11月以后发布的平台SDK。使用时既可以将 ExceptHandler.cpp/h 文件直接添加到C++工程中，也可以用DLL输出异常处理函数类，并用LoadLibrary函数在需要时动态加载DLL。
    ExceptHandler的二进制版本在XCPTHLR.DLL中提供。此DLL可以从本文最上方链接处下载。
    为了在客户机器上运行该代码，必须分发DBGHELP 5.1 动态链接库，这个库可以从2002年11月以后的平台SDK中获得。选择“Install Debugging Tools for Windows”选项安装该DLL。此外，还要注意DBGHELP 动态链接库在最新的 Windows 版本中是受到保护 Windows 系统文件，所以请将 DBGHELP 动态链接库放在与应用程序相同的目录中。
    为了在release模式中给代码提供符号，必须按照下列步骤修改工程设置：
    1. Project Settings -> Link -> Debug (Category) , 启用“Debug Info” 并选中“Microsoft Format”。
    2.相同的地方，选中“Separate Types”。
    3. 在相同页的“Project Options”编辑框中，添加“/OPT:REF”，这样可以保证从最终的二进制中排除掉未引用的函数。
    4. Project Settings -> C++ -> General (Category) Debug Info 组合框 -> 选择“Program Database”
    5. 如果要对无意义的堆栈进行调用，那么需将“Optimizations”设置为“Disable (Debug)”。
    还要记住与代码一起分发最终生成的pdb文件（或用其它方法使之可以得到）。以便CExceptionLogger能在最终的日志中给出源和行信息。
    请注意由于所有的符号，即便是很小的应用的符号，各自的异常日志可能超过100K。我的观点是磁盘空间不值钱，而开发人员为查找BUG所花的时间则很宝贵。
    参考资料：
    Bugslayer, MSJ, August 1998 by John Robbins,

        http://www.microsoft.com/msj/defaultframe.asp?page=/msj/0898/bugslayer0898.htm

    Under the Hood, MSDN, March 2002 by Matt Pietrek,

        http://msdn.microsoft.com/msdnmag/issues/02/03/Hood/Hood0203.asp
    改进计划：
    可配置日志文件名。
    提供对Win64平台的支持。
    提供对非x86 调用堆栈的支持。