如何捕捉程序异常/crash 并生成 dump 文件

前面介绍如如何用WinDBG 生成crash dump 《WinDBG 技巧：如何生成Dump 文件(.dump 命令)》，但是用户机器上通常不安装WinDBG， 而且多数用户也不知道怎么使用WinDBG。 所以最好是自己程序里面能够捕捉exception/crash，并且生成crash dump，然后通过网络传回到自己服务器。

捕捉exception 可以用API 函数 SetUnhandledExceptionFilter。生成crash dump 可以用DbgHelp.dll 里面的MiniDumpWriteDump函数。

LPTOP_LEVEL_EXCEPTION_FILTER WINAPI SetUnhandledExceptionFilter( __in LPTOP_LEVEL_EXCEPTION_FILTERlpTopLevelExceptionFilter );

BOOL WINAPI MiniDumpWriteDump( __in HANDLEhProcess, __in DWORDProcessId, __in HANDLEhFile, __in MINIDUMP_TYPEDumpType, __in PMINIDUMP_EXCEPTION_INFORMATIONExceptionParam, __in PMINIDUMP_USER_STREAM_INFORMATIONUserStreamParam, __in PMINIDUMP_CALLBACK_INFORMATIONCallbackParam );

代码示例：

[cpp] view plaincopyprint?

1. #include <dbghelp.h> 
2. #include <shellapi.h> 
3. #include <shlobj.h> 
4.  
5.  
6. // 自定义的exectpion filter 
7. LONG WINAPI MyUnhandledExceptionFilter(struct_EXCEPTION_POINTERS *pExceptionPointers) 
8. { 
9.  
10.     SetErrorMode( SEM_NOGPFAULTERRORBOX ); 
11.  
12.     //收集信息 
13.      CStringW strBuild; 
14.     strBuild.Format(L"Build: %s %s", __DATE__, __TIME__); 
15.     CStringW strError; 
16.     HMODULE hModule; 
17.     WCHAR szModuleName[MAX_PATH] = L""; 
18.     GetModuleHandleEx(GET_MODULE_HANDLE_EX_FLAG_FROM_ADDRESS, (LPCWSTR)pExceptionPointers->ExceptionRecord->ExceptionAddress, &hModule); 
19.     GetModuleFileName(hModule, szModuleName, ARRAYSIZE(szModuleName)); 
20.     strError.AppenedFormat(L"%s %d , %d ,%d.", szModuleName,pExceptionPointers->ExceptionRecord->ExceptionCode, pExceptionPointers->ExceptionRecord->ExceptionFlags, pExceptionPointers->ExceptionRecord->ExceptionAddress); 
21.  
22.     //生成 mini crash dump 
23.     BOOL bMiniDumpSuccessful; 
24.     WCHAR szPath[MAX_PATH];  
25.     WCHAR szFileName[MAX_PATH];  
26.     WCHAR* szAppName = L"AppName"; 
27.     WCHAR* szVersion = L"v1.0"; 
28.     DWORD dwBufferSize = MAX_PATH; 
29.     HANDLE hDumpFile; 
30.     SYSTEMTIME stLocalTime; 
31.     MINIDUMP_EXCEPTION_INFORMATION ExpParam; 
32.     GetLocalTime( &stLocalTime ); 
33.     GetTempPath( dwBufferSize, szPath ); 
34.     StringCchPrintf( szFileName, MAX_PATH, L"%s%s", szPath, szAppName ); 
35.     CreateDirectory( szFileName, NULL ); 
36.     StringCchPrintf( szFileName, MAX_PATH, L"%s%s//%s-%04d%02d%02d-%02d%02d%02d-%ld-%ld.dmp",  
37.                szPath, szAppName, szVersion,  
38.                stLocalTime.wYear, stLocalTime.wMonth, stLocalTime.wDay,  
39.                stLocalTime.wHour, stLocalTime.wMinute, stLocalTime.wSecond,  
40.                GetCurrentProcessId(), GetCurrentThreadId()); 
41.     hDumpFile = CreateFile(szFileName, GENERIC_READ|GENERIC_WRITE,  
42.                 FILE_SHARE_WRITE|FILE_SHARE_READ, 0, CREATE_ALWAYS, 0, 0); 
43.  
44.     MINIDUMP_USER_STREAM UserStream[2]; 
45.     MINIDUMP_USER_STREAM_INFORMATION UserInfo; 
46.     UserInfo.UserStreamCount = 1; 
47.     UserInfo.UserStreamArray = UserStream; 
48.     UserStream[0].Type = CommentStreamW; 
49.     UserStream[0].BufferSize = strBuild.GetLength()*sizeof(WCHAR); 
50.     UserStream[0].Buffer = strBuild.GetBuffer(); 
51.     UserStream[1].Type = CommentStreamW; 
52.     UserStream[1].BufferSize = strError.GetLength()*sizeof(WCHAR); 
53.     UserStream[1].Buffer = strError.GetBuffer(); 
54.  
55.     ExpParam.ThreadId = GetCurrentThreadId(); 
56.     ExpParam.ExceptionPointers = pExceptionPointers; 
57.     ExpParam.ClientPointers = TRUE; 
58.      
59.     MINIDUMP_TYPE MiniDumpWithDataSegs = MiniDumpNormal  
60.             | MiniDumpWithHandleData  
61.             | MiniDumpWithUnloadedModules  
62.             | MiniDumpWithIndirectlyReferencedMemory  
63.             | MiniDumpScanMemory  
64.             | MiniDumpWithProcessThreadData  
65.             | MiniDumpWithThreadInfo; 
66.     bMiniDumpSuccessful = MiniDumpWriteDump(GetCurrentProcess(), GetCurrentProcessId(),  
67.                     hDumpFile, MiniDumpWithDataSegs, &ExpParam, NULL, NULL); 
68.   // 上传mini dump 到自己服务器（略） 
69.   ... 
70.  
71.   return EXCEPTION_CONTINUE_SEARCH;//或者 EXCEPTION_EXECUTE_HANDLER 关闭程序 
72. } 
73.   
74. int _tmain() 
75. { 
76.   // 设置 execption filter 
77.   SetUnhandledExceptionFilter(MyUnhandledExceptionFilter); 
78.   .... 
79.   return 0; 
80. }