作者：@wordmeng

模块功能

添加当前模块大概功能的描述，希望不要把所有接口文档写在一个文件中，至少按模块分类。

捕获windows错误消息
FormatMessage函数的用法
这个函数是用来格式化消息字符串，就是处理消息资源的。消息资源是由mc.exe编译的
```
DWORD FormatMessage(
DWORD   dwFlags,
LPCVOID lpSource,
DWORD   dwMessageId,
DWORD   dwLanguageId,
LPTSTR  lpBuffer,
DWORD   nSize,
va_list *Arguments
);
```
参数的详细介绍如下：
dwFlags :
格式化选项，对lpSource参数值有指导作用。
dwFlags的低位值指定了函数如何处理输出缓冲区处理行转换，也可以指定格式化输出字符串输出行的最大宽度。它的位标示符如下：

Value	Meaning
FORMAT_MESSAGE_ALLOCATE_BUFFER 0x00000100	lpBuffer参数是一个PVOID指针，nSize参数指定按TCHARs为单位的分配给输出消息缓冲区的最小值。当你不适用这个缓冲区的时候也就是lpBuffer的时候需要用LocalFree将其释放
FORMAT_MESSAGE_ARGUMENT_ARRAY 0x00002000	Arguments参数不是一个va_list结构，但是它表示一个数组指针。这个标识符不能在64位整数值时使用，你如果要使用64位整数值，那么你必须使用va_list结构体
FORMAT_MESSAGE_FROM_HMODULE 0x00000800	lpSource参数是一个包含了消息表资源（Message-table resources）模块（dll）句柄。如果lpSource句柄为NULL，系统会自动搜索当前进程文件的消息资源。这个标示符不可以和FORMAT_MESSAGE_FROM_STRING共用。如果模块中没有资源表，这个函数执行失败并且返回ERROR_RESOURCE_TYPE_NOT_FOUND错误值。
FORMAT_MESSAGE_FROM_STRING 0x00000400	lpSource参数指向一个包含了消息定义的字符串.这个消息定义里面可能包含了插入序列（insert sequence），像消息表资源中包含消息文本一样.和这个标示符不和FORMAT_MESSAGE_FROM_HMODULE或者FORMAT_MESSAGE_FROM_SYSTEM一起使用.
FORMAT_MESSAGE_FROM_SYSTEM 0x00001000	函数将会搜索系统消息表资源来寻找所需消息资源。如果这个标示符同时定义了FORMAT_MESSAGE_FROM_HMODULE,那么如果函数在模块中没有搜索到所需消息的话将会在系统中搜索。这个标示符不能和FORMAT_MESSAGE_FROM_STRING一起使用. 当这个标示符设置的时候，可以使用GetLastError函数返回值来搜索这个错误码在系统定义错误中相应的消息文本。
FORMAT_MESSAGE_IGNORE_INSERTS 0x00000200	在消息定义中的插入序列将会被忽略，这个标示符在获取一个格式化好的消息十分有用，如果这个标示符设置好了，那么Arguments参数将被忽略。

开始在上面说了dwflags参数低位值作用，你可以使用以下值来设置低位值。

Value	Meaning
0	将不会有输出行宽度限制。
FORMAT_MESSAGE_MAX_WIDTH_MASK 0x000000FF	将会有限制输出行宽度，使用硬编码设定。

lpSource：
这个值是消息表资源来自哪里，这个值依靠dwFlags,详细请看FORMAT_MESSAGE_FROM_HMODULE和FORMAT_MESSAGE_FROM_STRING，如果这两个标示符都没设置，那么lpSource将会被忽略。

dwMessageId __：
所需格式化消息的标识符。当dwFlags设置了FORMAT_MESSAGE_FROM_STRING，这个参数将会被忽略。

dwLanguageId**：**
格式化消息语言标识符。

lpBuffer：
一个缓冲区指针来接受格式化后的消息。当dwFlags包括了FORMAT_MESSAGE_ALLOCATE_BUFFER标志符，这个函数将会使用LocalAlloc函数分配一块缓冲区，lpBuffer需要接受一个地址来使用这个缓冲区。（这里要注意传参一定要传地址）。

nSize：
如果FORMAT_MESSAGE_ALLOCATE_BUFFER没有设置，那么这个参数指定了输出缓冲区的消息，以TCHARs为单位。如果FORMAT_MESSAGE_ALLOCATE_BUFFER设置了，这个参数设置以TCHARs为单位的输出缓冲区的最小值。这个输出缓冲区不能大于64KB。

Arguments:
一个数组中的值在格式化消息中作为插入值，根据消息文本的格式里面的内容（详见mc.exe使用），可以知道%n[!format_specifier!]为这个参数的指定形式。
比如说在格式字符串中的%1为数组中的第一个值，%2为第二个值。n就代表数组第几个值。
那么[！format_specifier!]如何解释呢？这个格式化指定具体解释在 Format Specification Fields，也就是printf的格式形式安排。
在msdn中可以搜索Format Specification Fields: printf and wprintf Functions关键字进行查询详细的值。

c++代码运行结果

以上运行输出是乱码，我们该用MFC运行试试

代码实现

//在.h中添加两个变量
    afx_msg void OnBnClickedOk();
    afx_msg void OnStnClickedStatic1();
//在cpp中添加如下代码
void CerrorDlg::OnBnClickedOk()
{
    // TODO: 在此添加控件通知处理程序代码
    //接收系统指令
    TCHAR str[200];
    UpdateData(1);
    FormatMessage(FORMAT_MESSAGE_FROM_SYSTEM | FORMAT_MESSAGE_IGNORE_INSERTS,
        0, m_value, 0, (LPWSTR)str, 200, 0);
    //printf("%s", str);
    //this->SetDlgItemTextW(IDC_STATIC1, str);
    SetDlgItemTextW(IDC_STATIC1, str);
}
//方法二：自动分配内存方式
void CerrorDlg::OnBnClickedOk()
{
    // TODO: 在此添加控件通知处理程序代码
    TCHAR* str = NULL;
    UpdateData(1);
    //FORMAT_MESSAGE_ALLOCATE_BUFFER 自动分配内存，需要手动释放内存
    FormatMessage(FORMAT_MESSAGE_FROM_SYSTEM | FORMAT_MESSAGE_IGNORE_INSERTS|FORMAT_MESSAGE_ALLOCATE_BUFFER,
        0, m_value, 0, (LPWSTR)&str, 0, 0);
    //printf("%s", str);
    //this->SetDlgItemTextW(IDC_STATIC1, str);
    SetDlgItemTextW(IDC_STATIC1, str);
    LocalFree(str);
}

windows核心编程

windows核心编程-第一章

模块功能

FormatMessage函数的用法

c++代码运行结果

代码实现

结果展示