dump文件生成與調試（VS2008）

　　總結一下dump文件生成和調試的方法：　　

　　1：用SetUnhandledExceptionFilter捕獲未處理的異常，包含頭文件<windows.h>。函數原型為：

LPTOP_LEVEL_EXCEPTION_FILTER WINAPI SetUnhandledExceptionFilter(
    __in  LPTOP_LEVEL_EXCEPTION_FILTER lpTopLevelExceptionFilter
);

　　SetUnhandledExceptionFilter返回值為：The SetUnhandledExceptionFilter function returns the address of the previous exception filter established with the function. A NULL return value means that there is no current top-level exception handler.返回回掉函數的地址。

　　回掉函數原型為：

typedef LONG (WINAPI *PTOP_LEVEL_EXCEPTION_FILTER)(
    __in struct _EXCEPTION_POINTERS *ExceptionInfo
    );
typedef PTOP_LEVEL_EXCEPTION_FILTER LPTOP_LEVEL_EXCEPTION_FILTER;

　　回掉函數須返回以下3種類型：

Value	Meaning
EXCEPTION_EXECUTE_HANDLER 0x1	Return from UnhandledExceptionFilter and execute the associated exception handler. This usually results in process termination.捕獲到異常，並在異常處結束程序。
EXCEPTION_CONTINUE_EXECUTION 0xffffffff	Return from UnhandledExceptionFilter and continue execution from the point of the exception. Note that the filter function is free to modify the continuation state by modifying the exception information supplied through its LPEXCEPTION_POINTERS parameter.表示錯誤已經被修復,從異常發生處繼續執行。如果在回掉函數內部不對異常進行處理，每次回掉結束又會捕獲到異常，將導致無限進入SetUnhandledExceptionFilter函數，死循環。
EXCEPTION_CONTINUE_SEARCH 0x0	Proceed with normal execution of UnhandledExceptionFilter. That means obeying the SetErrorMode flags, or invoking the Application Error pop-up message box.捕獲到異常，並調用系統默認異常錯誤框,結束程序。

　　2：在SetUnhandledExceptionFilter的回掉函數中，用MiniDumpWriteDump函數將異常寫入dump文件。需要包含DbgHelp.h，引入#pragma comment(lib, "dbghelp.lib")。MiniDumpWriteDump函數的原型為：

BOOL WINAPI MiniDumpWriteDump(
  __in          HANDLE hProcess, 　　　　　　　　　　　　　　　　　　　　　　//　　進程句柄，可以用GetCurrentProcess()獲得
  __in          DWORD ProcessId,　　　　　　　　　　　　　　　　　　　　　　 //　　進程ID，可以用GetCurrentProcessId()獲得
  __in          HANDLE hFile,　　　　　　　　　　　　　　　　　　　　　　　　 //   待寫入的dmp文件
  __in          MINIDUMP_TYPE DumpType,　　　　　　　　　　　　　　　　　　 //　　寫入的dump信息類型，從MINIDUMP_TYPR中選擇。
  __in          PMINIDUMP_EXCEPTION_INFORMATION ExceptionParam,　　　　 //　　指向異常信息結構的指針，如果該值是NULL，將不會寫入任何異常信息　　
  __in          PMINIDUMP_USER_STREAM_INFORMATION UserStreamParam,　　 //　　 指向用戶自定義信息塊，可以為NULL
  __in          PMINIDUMP_CALLBACK_INFORMATION CallbackParam　　　　　　//　　 指向回掉函數的擴展信息塊，可以為NULL
);

　　在MiniDumpWriteDump參數項中，比較重要的是異常信息塊PMINIDUMP_EXCEPTION_INFORMATION，其結構如下：

typedef struct _MINIDUMP_EXCEPTION_INFORMATION {
    DWORD ThreadId;　　　　　　　　　　　　　　　　 //線程ID，可以用GetCurrentThreadId()獲得
    PEXCEPTION_POINTERS ExceptionPointers;　　　//指向異常信息指針，EXCEPTION_POINTER內包含了異常信息代碼/flag等內容，異常發生時各寄存器狀態和內容。用回掉函數的參數賦值即可 4     BOOL ClientPointers;　　　　　　　　　　　　　 //TRUE和FALSE好像都可以，搞不清楚區別
} MINIDUMP_EXCEPTION_INFORMATION, *PMINIDUMP_EXCEPTION_INFORMATION;

　　3：了解上述內容后，封裝成類，方便移植。h文件：

#pragma once
#include <string>
using namespace std;
class CCreateDump
{
public:
    CCreateDump();
    ~CCreateDump(void);
    static CCreateDump* Instance();
    static long __stdcall UnhandleExceptionFilter(_EXCEPTION_POINTERS* ExceptionInfo);
    //聲明Dump文件，異常時會自動生成。會自動加入.dmp文件名后綴
    void DeclarDumpFile(std::string dmpFileName = "");
private:
    static std::string    strDumpFile; 
    static CCreateDump*    __instance;
};

　　cpp文件：

#include "StdAfx.h"
#include "CreateDump.h"
#include <DbgHelp.h>
#pragma comment(lib,  "dbghelp.lib")

CCreateDump* CCreateDump::__instance = NULL;
std::string CCreateDump::strDumpFile = "";

CCreateDump::CCreateDump()
{
}

CCreateDump::~CCreateDump(void)
{
    
}

long  CCreateDump::UnhandleExceptionFilter(_EXCEPTION_POINTERS* ExceptionInfo)
{
    HANDLE hFile   =   CreateFile(strDumpFile.c_str(),   GENERIC_WRITE,   FILE_SHARE_WRITE,   NULL,   CREATE_ALWAYS,FILE_ATTRIBUTE_NORMAL,   NULL   );
    if(hFile!=INVALID_HANDLE_VALUE)
    {
        MINIDUMP_EXCEPTION_INFORMATION   ExInfo; 
        ExInfo.ThreadId   =   ::GetCurrentThreadId();
        ExInfo.ExceptionPointers   =   ExceptionInfo;
        ExInfo.ClientPointers   =   FALSE;
        //   write   the   dump
        BOOL   bOK   =   MiniDumpWriteDump(GetCurrentProcess(),   GetCurrentProcessId(),   hFile,   MiniDumpNormal,  &ExInfo,   NULL,   NULL   );
        CloseHandle(hFile);
        if (!bOK)
        {
            DWORD dw = GetLastError();
            //寫dump文件出錯處理,異常交給windows處理
            return EXCEPTION_CONTINUE_SEARCH;
        }
        else
        {    //在異常處結束
            return EXCEPTION_EXECUTE_HANDLER;
        }
    }
    else
    {
        return EXCEPTION_CONTINUE_SEARCH;
    }
}

void CCreateDump::DeclarDumpFile(std::string dmpFileName)
{
    SYSTEMTIME syt;
    GetLocalTime(&syt);
    char c[MAX_PATH];
    sprintf_s(c,MAX_PATH,"[%04d-%02d-%02d %02d：%02d：%02d]",syt.wYear,syt.wMonth,syt.wDay,syt.wHour,syt.wMinute,syt.wSecond);
    strDumpFile = std::string(c);
    if (!dmpFileName.empty())
    {
        strDumpFile += dmpFileName;
    }
    strDumpFile += std::string(".dmp");
    SetUnhandledExceptionFilter(UnhandleExceptionFilter);
}

CCreateDump* CCreateDump::Instance()
{
    if (__instance == NULL)
    {
        __instance = new CCreateDump;
    }
    return __instance;
}

　　調用方法：加入頭文件引用，在程序開始時寫入

CCreateDump::Instance()->DeclarDumpFile("dumpfile");

　　4：工程屬性設置，VS2008工程屬性->linker->debugging->Generate Debug Info選擇yes，生成pdb文件。

　　5：用vs2008打開dump文件，debug即可。