[Windows编程] 如何捕捉程序异常/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_FILTER lpTopLevelExceptionFilter );

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 );

代码示例：

view plaincopy to clipboardprint?
#include <dbghelp.h>   
#include <shellapi.h>   
#include <shlobj.h>   
  
  
// 自定义的exectpion filter   
LONG WINAPI MyUnhandledExceptionFilter(struct _EXCEPTION_POINTERS *pExceptionPointers)   
{   
  
    SetErrorMode( SEM_NOGPFAULTERRORBOX );   
  
    //收集信息   
     CStringW strBuild;   
    strBuild.Format(L"Build: %s %s", __DATE__, __TIME__);   
    CStringW strError;   
    HMODULE hModule;   
    WCHAR szModuleName[MAX_PATH] = L"";   
    GetModuleHandleEx(GET_MODULE_HANDLE_EX_FLAG_FROM_ADDRESS, (LPCWSTR)pExceptionPointers->ExceptionRecord->ExceptionAddress, &hModule);   
    GetModuleFileName(hModule, szModuleName, ARRAYSIZE(szModuleName));   
    strError.AppenedFormat(L"%s %d , %d ,%d.", szModuleName,pExceptionPointers->ExceptionRecord->ExceptionCode, pExceptionPointers->ExceptionRecord->ExceptionFlags, pExceptionPointers->ExceptionRecord->ExceptionAddress);   
  
    //生成 mini crash dump   
    BOOL bMiniDumpSuccessful;   
    WCHAR szPath[MAX_PATH];    
    WCHAR szFileName[MAX_PATH];    
    WCHAR* szAppName = L"AppName";   
    WCHAR* szVersion = L"v1.0";   
    DWORD dwBufferSize = MAX_PATH;   
    HANDLE hDumpFile;   
    SYSTEMTIME stLocalTime;   
    MINIDUMP_EXCEPTION_INFORMATION ExpParam;   
    GetLocalTime( &stLocalTime );   
    GetTempPath( dwBufferSize, szPath );   
    StringCchPrintf( szFileName, MAX_PATH, L"%s%s", szPath, szAppName );   
    CreateDirectory( szFileName, NULL );   
    StringCchPrintf( szFileName, MAX_PATH, L"%s%s\\%s-%04d%02d%02d-%02d%02d%02d-%ld-%ld.dmp",    
               szPath, szAppName, szVersion,    
               stLocalTime.wYear, stLocalTime.wMonth, stLocalTime.wDay,    
               stLocalTime.wHour, stLocalTime.wMinute, stLocalTime.wSecond,    
               GetCurrentProcessId(), GetCurrentThreadId());   
    hDumpFile = CreateFile(szFileName, GENERIC_READ|GENERIC_WRITE,    
                FILE_SHARE_WRITE|FILE_SHARE_READ, 0, CREATE_ALWAYS, 0, 0);   
  
    MINIDUMP_USER_STREAM UserStream[2];   
    MINIDUMP_USER_STREAM_INFORMATION UserInfo;   
    UserInfo.UserStreamCount = 1;   
    UserInfo.UserStreamArray = UserStream;   
    UserStream[0].Type = CommentStreamW;   
    UserStream[0].BufferSize = strBuild.GetLength()*sizeof(WCHAR);   
    UserStream[0].Buffer = strBuild.GetBuffer();   
    UserStream[1].Type = CommentStreamW;   
    UserStream[1].BufferSize = strError.GetLength()*sizeof(WCHAR);   
    UserStream[1].Buffer = strError.GetBuffer();   
  
    ExpParam.ThreadId = GetCurrentThreadId();   
    ExpParam.ExceptionPointers = pExceptionPointers;   
    ExpParam.ClientPointers = TRUE;   
       
    MINIDUMP_TYPE MiniDumpWithDataSegs = MiniDumpNormal    
            | MiniDumpWithHandleData    
            | MiniDumpWithUnloadedModules    
            | MiniDumpWithIndirectlyReferencedMemory    
            | MiniDumpScanMemory    
            | MiniDumpWithProcessThreadData    
            | MiniDumpWithThreadInfo;   
    bMiniDumpSuccessful = MiniDumpWriteDump(GetCurrentProcess(), GetCurrentProcessId(),    
                    hDumpFile, MiniDumpWithDataSegs, &ExpParam, NULL, NULL);   
  // 上传mini dump 到自己服务器（略）   
  ...   
  
  return EXCEPTION_CONTINUE_SEARCH; //或者 EXCEPTION_EXECUTE_HANDLER 关闭程序   
}   
    
int _tmain()   
{   
  // 设置 execption filter   
  SetUnhandledExceptionFilter(MyUnhandledExceptionFilter);   
  ....   
  return 0;   
}