学步园

         在我的上篇文章《让程序在崩溃时体面的退出之SEH+Dump文件》我介绍了怎样用SEH加上Dump文件来避免程序的崩溃并在程序崩溃时创建Dump文件来帮助定位出现异常的代码行。可是只有try/except块中try块中的代码出现异常才能被捕捉到，try块外面的代码出现异常，程序照样会崩溃。
        下面用《让程序在崩溃时体面的退出之SEH+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);
}

// 作为except块中表达式的函数
//
LONG CrashHandler(EXCEPTION_POINTERS *pException)
{	
	// 在这里添加处理程序崩溃情况的代码
	//

	// 这里以弹出一个对话框为例子
	//
	MessageBox(NULL, _T("Message from Catch handler"), _T("Test"), MB_OK);

	// 创建Dump文件
	//
	CreateDumpFile(_T("C:\\Test.dmp"), pException);

	return EXCEPTION_EXECUTE_HANDLER;
}

int _tmain(int argc, _TCHAR* argv[])
{
	__try
	{
		MessageBox(NULL, _T("Message from '__try' section"), _T("Test"), MB_OK);

		// 除零，人为的使程序崩溃
		//
		int i = 13;
		int j = 0;
		int m = i / j;
	}
	// 捕捉到让程序崩溃的异常时创建Dump文件
	//
	__except(CrashHandler(GetExceptionInformation()))
	{
		// 这里以弹出一个对话框为例子
		//
		MessageBox(NULL, _T("Message from '__except' section"), _T("Test"), MB_OK);
	}

	MessageBox(NULL, _T("Funcation completed"), _T("Test"), MB_OK);

	return 0;
}

        编译上面的代码并运行，会依次弹出下面这些对话框，并在C盘创建一个Dump文件Test.dmp。

        如果把上面代码中的main()函数改成下面的样子，运行编译后的程序依然会崩溃。

int _tmain(int argc, _TCHAR* argv[])
{
	__try
	{
		MessageBox(NULL, _T("Message from '__try' section"), _T("Test"), MB_OK);

		// 除零，人为的使程序崩溃
		//
		int i = 13;
		int j = 0;
		int m = i / j;
	}
	// 捕捉到让程序崩溃的异常时创建Dump文件
	//
	__except(CrashHandler(GetExceptionInformation()))
	{
		// 这里以弹出一个对话框为例子
		//
		MessageBox(NULL, _T("Message from '__except' section"), _T("Test"), MB_OK);
	}

	// 除零，人为的使程序崩溃
	//
	int i = 13;
	int j = 0;
	int m = i / j;

	MessageBox(NULL, _T("Funcation completed"), _T("Test"), MB_OK);

	return 0;
}

        这种情况在实际编程中是很有可能出现的，毕竟我们不可能事先预计到所有可能出现导致程序崩溃的情况，并把这些代码放到try/except块中。那么对于这些不可预知的异常该怎么办呢？这就要用到我那篇《让程序在崩溃时体面的退出之Unhandled Exception》中的方法：用Windows API中的SetUnhandledExceptionFilter设置一个回调函数来处理这些无法预料的异常。下面是在上面的例子代码上修改后的代码。其中函数CreateDumpFile没有任何变化。

// 得到当前时间
//
wstring GetPresentTime()
{
	 SYSTEMTIME time;
	 GetLocalTime(&time); 

	 wchar_t wszTime[128];
	 swprintf_s(wszTime, _T("%04d-%02d-%02d %02d-%02d-%02d-%03d"), time.wYear, time.wMonth, time.wDay, time.wHour, time.wMinute, time.wSecond, time.wMilliseconds);

	 return wstring(wszTime);
}

// 处理异常的回调函数
//
LONG CrashHandler(EXCEPTION_POINTERS *pException)
{	
	// 在这里添加处理程序崩溃情况的代码
	//

	// 这里以弹出一个对话框为例子
	//
	MessageBox(NULL, _T("Message from Catch handler"), _T("Test"), MB_OK);

	// 以当前时间为文件名
	//
	wstring strDumpFileName = _T("C:\\") + GetPresentTime() +_T(".dmp");

	// 创建Dump文件
	//
	CreateDumpFile(strDumpFileName.data(), pException);

	return EXCEPTION_EXECUTE_HANDLER;
}

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

	__try
	{
		MessageBox(NULL, _T("Message from '__try' section"), _T("Test"), MB_OK);

		// 除零，人为的使程序崩溃
		//
		int i = 13;
		int j = 0;
		int m = i / j;
	}
	__except(CrashHandler(GetExceptionInformation()))
	{
		// 在这里添加处理程序崩溃情况的代码
		//

		// 这里以弹出一个对话框为例子
		//
		MessageBox(NULL, _T("Message from '__except' section"), _T("Test"), MB_OK);
	}

	// 除零，人为的使程序崩溃
	//
	int i = 13;
	int j = 0;
	int m = i / j;

	MessageBox(NULL, _T("Funcation completed"), _T("Test"), MB_OK);

	return 0;
}

        编译上面的代码，运行生成的EXE文件，可以看到在弹出上面提到的那一系列的对话框后，程序正常退出，没有崩溃。同时，在C盘下生成了2个Dump文件，文件名指出了发生异常的时刻。

        上面的代码仅仅是为了说明怎样配合使用SEH和SetUnhandledExceptionFilter，所以except后的表达式和SetUnhandledExceptionFilter中所设置的回调函数都使用了同一个函数CrashHandler。在实际的应用中可以根据不同的需求而使用不同的函数。这个函数的参数必须是一个指向EXCEPTION_POINTERS的指针，返回值必须是这3个中的一个：EXCEPTION_CONTINUE_SEARCH，EXCEPTION_CONTINUE_EXECUTION，EXCEPTION_EXECUTE_HANDLER。这3个值的具体含义可以查阅MSDN或者我的那篇《让程序在崩溃时体面的退出之SEH》。
        实际情况下，是不应该用同一个回调函数的。因为在except表达式中的函数是处理try块中的代码异常的；而用SetUnhandledExceptionFilter设置的回调函数是用来处理代码中没有被捕捉到的异常的。对于未被捕捉到的异常，这个回调函数是不知道异常发生的地方的，虽然可以通过异常代码知道异常的类型，但是由于不知道是什么状况引起的异常，所以没法做出相应的异常处理。一般情况下，这个回调函数是应用程序崩溃前的最后一道防线，这个函数中的代码被执行完后，应用程序就会被终止。所以，大部分的应用程序，在这个函数里都是弹出一个发送错误报告的对话框，来告诉用户程序发生异常，需要终止，可以把错误报告（一般是包括Dump文件和一些必要的文本信息）发送到指定地方帮助开发者来修改代码缺陷，以提高软件质量。

        使用上面的方法编写出的应用程序不会崩溃，并且在出现异常的时候会产生Dump文件。程序的使用者会获得非常良好的用户体验。如果再给应用程序添加上Log信息，配合上Dump文件，就可以很轻松的定位程序中的异常，帮助开发者快速的修复代码中的错误。