MiniDump - 調試問題的基礎

前言

這個minidump對於在windows平臺上調試程序問題是十分重要的，所以有必要提一下。

之前我有一個博客說的很詳細了，但是因爲同事借我的賬號亂下載文件，所以直接給註銷了。換了一家公司以後，發現他們的程序完全沒有Dump檢測機制，有點不放心，然後大致搜索，回顧一番了，決定還是再記錄一遍。

代碼

#include <tchar.h>
#include <shlwapi.h>
#include <dbghelp.h>
#include <Windows.h>
#pragma comment(lib, "Dbghelp.lib")
#pragma comment(lib, "shlwapi.lib")

int GenerateMiniDump(PEXCEPTION_POINTERS pExceptionPointers)
{
	// 定義函數指針
	 typedef BOOL(WINAPI * MiniDumpWriteDumpT)(
	  HANDLE,
	  DWORD,
	  HANDLE,
	  MINIDUMP_TYPE,
	  PMINIDUMP_EXCEPTION_INFORMATION,
	  PMINIDUMP_USER_STREAM_INFORMATION,
	  PMINIDUMP_CALLBACK_INFORMATION
	  );
	  
	 // 從 "DbgHelp.dll" 庫中獲取 "MiniDumpWriteDump" 函數
	 MiniDumpWriteDumpT pfnMiniDumpWriteDump = NULL;
	 HMODULE hDbgHelp = LoadLibrary(_T("DbgHelp.dll"));
	 if (NULL == hDbgHelp)
	 {
	 	return EXCEPTION_CONTINUE_EXECUTION;
	 }
	 pfnMiniDumpWriteDump = (MiniDumpWriteDumpT)GetProcAddress(hDbgHelp, "MiniDumpWriteDump");

	if (NULL == pfnMiniDumpWriteDump)
	 {
		 FreeLibrary(hDbgHelp);
		 return EXCEPTION_CONTINUE_EXECUTION;
	 }
	 // 創建 dmp 文件件
	 TCHAR szFileName[MAX_PATH] = { 0 };
	 SYSTEMTIME stLocalTime;
	 GetLocalTime(&stLocalTime);
	 wsprintf(szFileName, L"%04d-%02d-%02d %02d-%02d-%02d.dmp", 
stLocalTime.wYear, stLocalTime.wMonth, stLocalTime.wDay, 
stLocalTime.wHour, stLocalTime.wMinute, stLocalTime.wSecond);
	 HANDLE hDumpFile = CreateFile(szFileName, GENERIC_READ | GENERIC_WRITE, 
FILE_SHARE_WRITE | FILE_SHARE_READ, 0, CREATE_ALWAYS, 0, 0);
	 if (INVALID_HANDLE_VALUE == hDumpFile)
	 {
		 FreeLibrary(hDbgHelp);
		 return EXCEPTION_CONTINUE_EXECUTION;
	 }
	
	// 寫入 dmp 文件
	 MINIDUMP_EXCEPTION_INFORMATION expParam;
	 expParam.ThreadId = GetCurrentThreadId();
	 expParam.ExceptionPointers = pExceptionPointers;
	 expParam.ClientPointers = FALSE;
	 pfnMiniDumpWriteDump(GetCurrentProcess(), GetCurrentProcessId(), 
hDumpFile, MiniDumpWithDataSegs, (pExceptionPointers ? &expParam : NULL), NULL, NULL);
	 // 釋放文件
	 CloseHandle(hDumpFile);
	 FreeLibrary(hDbgHelp);
	 return EXCEPTION_EXECUTE_HANDLER;
}

LONG WINAPI ExceptionFilter(LPEXCEPTION_POINTERS lpExceptionInfo)
{
	// 這裏做一些異常的過濾或提示
	if (IsDebuggerPresent())
	{
	 	return EXCEPTION_CONTINUE_SEARCH;
	}
	return GenerateMiniDump(lpExceptionInfo);
}

在main函數的地方註冊一下ExceptionFilter即可：

SetUnhandledExceptionFilter(ExceptionFilter);

注意，dmp文件名千萬不要加 ： 這個字符，否則會一直停留在dump檢測這裏，建議還是和編程一樣去命名這個文件名。

這種方式對於debug和release版的程序都可以使用，前提是你在編譯的時候生成了對應的pdb文件。方法如下：

屬性  ->  鏈接器  ->  調試  ->  生成調試信息  改爲  生成調試信息 (/DEBUG) 這樣就可以生成pdb文件了