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

2019-11-17 05:34:39

字体：大中小

来源：转载

供稿：网友

下载源代码和例子

简介：

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

改进计划：