转载请说明原出处,谢谢~ http://blog.youkuaiyun.com/seven_1992/article/details/44487785
在WINDOWS编程中,我们在所难免会与“错误”打交道,但令我们“找不着北”的是,我们不知道是什么错误(What's Error?),亦或者是系统给出了错误代码(Error Code),而我们却郁闷着怎么没有详细的错误信息(Error Information),这样一个错误代码到底要表达什么意思(What's mean?)。 接下来要登场的就是几个与错误信息有关的系统API函数了,关于错误信息的处理与参考,下面就让我们来看看这几个函数吧。
一、 设置和获取错误代码
当我们在代码运行的过程中,发生了错误,要获取或者设置错误信息,我们就要用到两个与此相关的函数 GetLastError()与SetLastError(),可以看出,这是一对兄弟函数(Sibling Function),函数的命名总是这样,Get函数与Set函数总是成对出现,其实在我们平时与代码打交道的日子里算是家常了,关于这两个函数我们接下来就先来了解一下吧。
1、GetLastError()函数:
DWORD WINAPI GetLastError(void); // 获取最后一次错误代码
这是MSDN上函数的原型,返回值为DWORD(双字型),函数调用约定为宏WINAPI(即__stdcall标准调用),输入参数为void(空参数型),MSDN上对该函数的解释是:获取该调用线程的最后一次错误错代码,该错误代码是基于线程的,多线程中各自线程的错误代码是独立而不相互覆盖的(简而言之,错误代码是线程级别拥有的,你使用该函数获取到的错误代码是该线程的)。
2、SetLastError()函数:
void WINAPI SetLastError(_In_ DWORD dwErrCode); // 设置错误代码
顾名思义,这个函数的作用也就是设置最后一次出错代码(Last-error Code),其实理解了它的兄弟函数GetLastError()的,我想对于这个函数的理解和运用也就不是那么难了。(同样,该函数设置的错误代码也是线程级别的)
对于SetLastError()函数,同样有着一个扩展函数(Extension Function):
void WINAPI SetLastErrorEx(
_In_ DWORD dwErrCode,
_In_ DWORD dwType
);
MSDN目前给出的解释是:目前,由于第二个参数暂时被忽略,该函数等同于SetLastError()。
PS. 关于错误代码(Error Code),MSDN上还有这样一段注释:
错误代码是一个32位值,最高位也就是第31位是最重要的一位。第29位是专门用来给应用程序定义错误的(非系统错误该位必须设置),如果你要给应用程序定义错误,请设置此位为1,以表明该错误代码是由应用程序定义的。你需要保证你定义的错误代码不与系统定义的错误代码相冲突。
二、 格式化错误信息
当然我们会说,GetLastError()与SetLastError()两个函数也就是设置和获取错误代码,而既然是代码,我怎么知道这代码要表达的是什么意思?没关系,接下来要登场的就是我们的FormatMessage()函数:
DWORD WINAPI FormatMessage( // 返回值DWORD是消息格式化后的长度