Windows API一日一练(81)FormatMessage函数

时间:2022-02-20 05:54:28
在开发软件的过程里,经常要做的工作就是调试程序,许多问题的出现,不但是逻辑的问题,还有可能是对API的不熟悉,或者某种条件下调用API会出错的。那么这些出错的原因是什么呢?通常只获取到错误码,也就是通过函数GetLastError得到。当然可以根据这个错误码去查找MSDN就可以知道出错的原因,但有时在客户那里并没有MSDN,那么就需要把调用API函数出错的信息显示出来,或者写到LOG里去。这时就需要调用函数FormatMessage把出错码详细原因显示出来。
 
函数 FormatMessage 声明如下:
 
WINBASEAPI
DWORD
WINAPI
FormatMessageA(
    DWORD dwFlags,
    LPCVOID lpSource,
    DWORD dwMessageId,
    DWORD dwLanguageId,
    LPSTR lpBuffer,
    DWORD nSize,
    va_list *Arguments
    );
WINBASEAPI
DWORD
WINAPI
FormatMessageW(
    DWORD dwFlags,
    LPCVOID lpSource,
    DWORD dwMessageId,
    DWORD dwLanguageId,
    LPWSTR lpBuffer,
    DWORD nSize,
    va_list *Arguments
    );
#ifdef UNICODE
#define FormatMessage FormatMessageW
#else
#define FormatMessage FormatMessageA
#endif // !UNICODE
 
调用函数的例子如下:
#001 // 系统错误信息提示。
#002  // 蔡军生  2007/11/28 QQ:9073204 深圳
#003  void TestErrorInfo(void)
#004  {
#005         // 进行出错。
#006         if (!CreateDirectory(_T("c://"),0))
#007         {
#008               TCHAR szBuf[128];
#009               LPVOID lpMsgBuf;
#010               DWORD dw = GetLastError();
#011 
#012              FormatMessage(
#013                   FORMAT_MESSAGE_ALLOCATE_BUFFER |
#014                   FORMAT_MESSAGE_FROM_SYSTEM,
#015                   NULL,
#016                   dw,
#017                   MAKELANGID(LANG_NEUTRAL, SUBLANG_DEFAULT),
#018                   (LPTSTR) &lpMsgBuf,
#019                   0, NULL );
#020 
#021                wsprintf(szBuf,
#022                    _T("%s 出错信息 ( 出错码= %d): %s"),
#023                    _T("CreateDirectory"), dw, lpMsgBuf);
#024 
#025               LocalFree(lpMsgBuf);
#026 
#027               // 输出提示。
#028               OutputDebugString(szBuf);
#029         }
#030        
#031  }
 
调用后输出下面的提示信息:
CreateDirectory 出错信息 (出错码=5): 拒绝访问。