错误码转换为文本(Win32, C++)

#include <wtypesbase.h>
#include <string>
#include <tchar.h>

#ifdef _UNICODE
using _tstring = std::wstring;
#else
using _tstring = std::string;
#endif

//获取GetLastError()的错误信息文本
_tstring CStrUtils::GetErrorMessage(DWORD dwMessageId, DWORD dwLanguageId/* = MAKELANGID(LANG_NEUTRAL, SUBLANG_DEFAULT)*/)
{
    _tstring strResult;

    LPTSTR lpBuffer = NULL;
    DWORD dwFlags = 
        FORMAT_MESSAGE_ALLOCATE_BUFFER |    //函数分配一个足够大的缓冲区来保存格式化消息，并将指针放置在 lpBuffer 指定的地址处分配的缓冲区
        FORMAT_MESSAGE_FROM_SYSTEM |        //函数应在系统消息表资源搜索请求的消息
        FORMAT_MESSAGE_IGNORE_INSERTS |     //将忽略消息定义中的插入序列（如 %1）
        FORMAT_MESSAGE_MAX_WIDTH_MASK;      //函数忽略消息定义文本中的常规

    ::FormatMessage(
        dwFlags,            //格式设置选项以及如何解释 lpSource 参数
        NULL,               //消息定义的位置。 此参数的类型取决于 dwFlags 参数中的设置
        dwMessageId,        //请求的消息的消息标识符。 如果 dwFlags 包含 FORMAT_MESSAGE_FROM_STRING，则忽略此参数
        dwLanguageId,       //所请求消息 的语言标识符
        (LPTSTR)&lpBuffer,  //指向缓冲区的指针
        MAX_PATH,           //如果未设置 FORMAT_MESSAGE_ALLOCATE_BUFFER 标志，则此参数以 TCHAR 为单位指定输出缓冲区的大小。 如果设置了 FORMAT_MESSAGE_ALLOCATE_BUFFER ，则此参数指定要为输出缓冲区分配的最小 TCHAR 数
        NULL                //一个值数组，这些值用作格式化消息中的插入值。 格式字符串中的 %1 指示 Arguments 数组中的第一个值;%2 指示第二个参数;等等
    );

    if (NULL != lpBuffer)
    {
        strResult = lpBuffer;
        ::LocalFree(lpBuffer);
    }

    return strResult;
}