Windows系统消息的自定义和显示 - Windows via c/c++

在Windows via c/c++书中，下面是学习错误消息处理和显示的一些笔记：

 我们知道GetLastError()函数可以取得最后一次Windows API调用的错误的代码。
后面讨论怎么样自己定义错误消息，这在创建函数让别人调用时场合就很有用。要产生这样的
错误消息，首先你需要在发生错误时设置线程的最后错误代码：
VOID SetLastError(DWORD dwErrCode)
另外你的函数需要返回FALSE，INVALID_HANDLE_VALUE或NULL等值。
在使用SetLastError函数，最后传递在WinError.h中已定义的错误值，如果在WinError.h的错误中没有
你的那种错误类型，当然你需要定义它。在定义时唯一要注意的是这个值的第29位：它如果是0，说明是
Microsoft定义的错误消息代码，你自己的错误消息代码应该把它设置成1。这些位意义如下：

31-30   29      		28    	27-16  	15-0
0:成功  0:Microsoft  	必须为0  	简易码 	异常码
1:消息  1:自定义
2:警告
3:错误

那如何把错误消息代码显示成可读的形式呢？它可借助于FormatMessage函数，该函数最大的特色
是它能以特定的语言显示的消息。其中消息定义可以来自已加载模块的消息资源表，系统消息资源
表，并按消息标识符和语言标识符查找消息资源表，然后拷贝格式化的消息文本到输出缓冲区，
如果需要也可以处理任何的插入序列。该函数定义如下：
DWORD WINAPI FormatMessage(
 __in DWORD dwFlags, //它用于如何解释后一个参数意义，其低字节指定如何处理输出缓冲区的
            //换行符，而高字节指定格式化输出行的最大宽度
 __in  LPCVOID lpSource, //它依据dwFlags标识而定，总之它是指向某个资源或非格式化的字符串
 __in  DWORD dwMessageId, //消息标识符
 __in DWORD dwLanguageId, //相应的语言Id，如果传递0，则它按某种规则使用某语言
 __out LPSTR lpBuffer,   //输出缓冲区，它不能大于64K
 __in DWORD nSize,    //它指定了输出缓冲区最小的TCHAR数目
 __in va_list* Arguments //用于在格式字符串中插入值。
)
如果函数成功，就返回输出缓冲区中的TCHAR数目，失败返回0。记住很多时间返回的缓冲区
要使用LocalFree释放，具体见SDK文档。

有了这个函数，就可以如下方式显示错误消息代码的文本了：
//假定错误消息码在 dwError中，而hlocal是HLOCAL类型，它代表输出缓冲区(可用NULL初始化)
//而systemLocale是语言标识符，它获取方式如下：
//DWORD systemLocale = MAKELANGID(LANG_NEUTRAL, SUBLANG_NEUTRAL);
BOOL fOk = FormatMessage(FORMAT_MESSAGE_FROM_SYSTEM|FROMAT_MESSAGE_IGNORE_INSERTS|
     FORMAT_MESSAGE_ALLOCATE_BUFFER, NULL, dwError, systemLocale,
     (PTSTR)&hlocal, 0, NULL);

系统的消息表定义于资源DLL中：netmsg.dll，如果在上述显示时如果发生失败，可以直接加载这个DLL
再显示。