一、Windows API错误机制
当我们在自己的代码里调用Windows系统的API函数,系统执行API内部代码,当API内部代码出现错误,会将预先定义好的错误代码写到调用这个API的线程局部存储区域(这个区域是每个线程独有的其他线程无法更改。它存储着一些线程独有的东西),然后API返回,返回值告诉我们该API执行失败了。如果我们的代码加了检测,发现了API失败,这时我们调用GetLastError() 函数去获取这个错误代码,这个错误代码是一个DWORD值。如果我们不及时获取,就会被后面调用的API所覆盖。当我们想在自己的函数里借用这种机制时,可以调用SetLastError函数来设置一个错误代码。
这里我们提到了两个API:
DWORD GetLastError(VOID)
void SetLastError(DWORD dwErrCode)
我们可以看到,ErrorCode是一个32 bit的值。
二、Windows 错误代码(Error Code)
2.1、Windows错误代码域
前面我们知道错误代码是一个DWORD值,那么这个值得没一位或几位代表什么意思,Windows是由规定的,错误代码域也就是说错误代码的定义规则是怎样的。
每个错误代码的DWORD值被划分成了几个部分,如下:
2.2、错误代码的生成
2.2.1、编写错误信息文本文件
应用程序可以根据业务需求按照Windows错误代码域的规则定义自己的错误码, 自定义错误码需要先编写一个错误信息文本文件。文件以.mc为后缀,其语法相对来说比较简单,该文件主要包括三部分,注释、信息头(Header Section)和信息体(Message Section)。
注释
注释是以分号(;)开头的行,在编译后生成的C/C++头文件中,MC编译器会去掉这些分号,也就是说,如果你要生成一些带C/C++的注释,在分号后再加入C/C++的注释即可,如:
;#ifndef _YOUR_MESSAGE_ERROR_TEXT_
;#define _YOUR_MESSAGE_ERROR_TEXT_
;// C/C++单行注释
;
;/*
;
; C/C++块注释
;
;*/
;#endif