让程序在崩溃时体面的退出之Dump文件

         在我的那篇《让程序在崩溃时体面的退出之CallStack》中提供了一个在程序崩溃时得到CallStack的方法。但是要想得到CallStack，必须有pdb文件的支持。但是普通情况下，公布出去的程序都是Release版本号的，都不会附带pdb文件。那么我们怎么能在程序崩溃的时候找到出错的详细位置呢？这个时候就该Dump文件出场了！Dump文件是进程的内存镜像，能够把程序执行时的状态完整的保存下来。
        要想在程序崩溃的时候创建Dump文件，就须要用到DbgHelp.dll中Windows API的MiniDumpWriteDump()函数。该函数声明例如以下：

BOOL WINAPI MiniDumpWriteDump(
  __in  HANDLE hProcess,
  __in  DWORD ProcessId,
  __in  HANDLE hFile,
  __in  MINIDUMP_TYPE DumpType,
  __in  PMINIDUMP_EXCEPTION_INFORMATION ExceptionParam,
  __in  PMINIDUMP_USER_STREAM_INFORMATION UserStreamParam,
  __in  PMINIDUMP_CALLBACK_INFORMATION CallbackParam
);

        具体的參数和返回值的解释能够查找MSDN，有非常具体的说明。以下依旧用上一篇文章中的样例代码来说明怎么在程序崩溃的时候创建Dump文件。

// 处理Unhandled Exception的回调函数
//
LONG ApplicationCrashHandler(EXCEPTION_POINTERS *pException)
{	
	// 这里弹出一个错误对话框并退出程序
	//
	FatalAppExit(-1,  _T("*** Unhandled Exception! ***"));

	return EXCEPTION_EXECUTE_HANDLER;
}

// 一个有函数调用的类
// 
class CrashTest
{
public:
	void Test() 
	{ 
		Crash(); 
	}

private:
	void Crash() 
	{ 
		// 除零，人为的使程序崩溃
		//
		int i = 13;
		int j = 0;
		int m = i / j;
	}
};

int _tmain(int argc, _TCHAR* argv[])
{
	// 设置处理Unhandled Exception的回调函数
	// 
	SetUnhandledExceptionFilter((LPTOP_LEVEL_EXCEPTION_FILTER)ApplicationCrashHandler); 

	CrashTest test;
	test.Test();

	return 0;
}

        在上面的程序崩溃的时候，会调用函数ApplicationCrashHandler()。创建Dump文件的代码就须要加入到该函数中。以下就是一个创建Dump文件的函数。

// 创建Dump文件
// 
void CreateDumpFile(LPCWSTR lpstrDumpFilePathName, EXCEPTION_POINTERS *pException)
{
	// 创建Dump文件
	//
	HANDLE hDumpFile = CreateFile(lpstrDumpFilePathName, GENERIC_WRITE, 0, NULL, CREATE_ALWAYS, FILE_ATTRIBUTE_NORMAL, NULL);

	// Dump信息
	//
	MINIDUMP_EXCEPTION_INFORMATION dumpInfo;
	dumpInfo.ExceptionPointers = pException;
	dumpInfo.ThreadId = GetCurrentThreadId();
	dumpInfo.ClientPointers = TRUE;

	// 写入Dump文件内容
	//
	MiniDumpWriteDump(GetCurrentProcess(), GetCurrentProcessId(), hDumpFile, MiniDumpNormal, &dumpInfo, NULL, NULL);

	CloseHandle(hDumpFile);
}

        在函数ApplicationCrashHandler()用相似以下的代码来调用上面的函数，就能够在程序崩溃的时候创建Dump文件。

CreateDumpFile(_T("C:\Test.dmp"), pException);

        以下简单说一下Dump文件的使用方法。将Dump文件复制到含有应用程序和相应的pdb文件的文件夹，在VS里面打开Dump文件（或者直接双击Dump文件），VS会自己主动创建一个Solution，直接调试执行，代码就会停到使程序崩溃的那一行上。就跟在VS里面调试代码一摸一样。（VS2008）

        在VS2010里打开Dump文件，会显示一个Minidump File Summary，而且能够进行以下图中的操作。