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文件了