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

在开发软件的过程里，经常要做的工作就是调试程序，许多问题的出现，不但是逻辑的问题，还有可能是对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): 拒绝访问。