【windows核心编程】第一章 错误处理

 

1、常见的windows函数返回类型

 1 VOID      //不返回任何类型，不会失败
 2 
 3 BOOL     //TRUE for FALSE, typedef int BOOL
 4 
 5 HANDLE    //句柄类型，函数失败返回NULL 或 INVALID_HANDLE_VALUE，后者INVALID_HANDLE_VALUE被定义为宏((HANDLE)(LONG_PTR)-1), 其中LONG_PTR被定义为
 6 
 7                         //Typedef _W64 long LONG_PTR, *PLONG_PTR， LONG_PTR在VC++ WIN32配置下为32位，在X64配置下为64位。
 8 
 9 PVOID               //PVOID被定义为typedef void *PVOD; 如果函数失败返回NULL，否则返回一个标志内存块的指针
10 
11 LONG/DWORD   //其返回值代表的含义需要根据MSDN的解释来，没有固定招数，其中DWORD被定义为unsigned long

 

 

2、关于错误代码

 1 DWORD GetLastError();
 2 
 3 错误代码在winerror.h中定义
 4 
 5 #define ERROR_SUCCESS   0L
 6 
 7 #define NO_ERROR        0L
 8 
 9 //MessageID   GetLastError返回值
10 
11 //MessageText  错误描述信息

 

 

一个windows函数失败之后应该立即调用GetLastError获得其错误代码，当windows检测到错误时会使用“线程本地存储(Thread-Local-Storage)”的机制来将相应的错误代码和主调线程关联到一起。

调试程序时，在Visual Studio的watch窗口Name字段中输入:$err,hr ，这样在调试时即可随时查看windows函数的GetLastError的值和对应的描述信息。

 

根据错误代码获得其对应的文本描述信息的方法：

 1 DWORD FormatMessage(
 2 
 3          DWORD  dwFlags, //标记
 4 
 5          LPCVOID  pSource, //表明这个值是消息资源来自哪里，依赖dwFlags
 6 
 7          DWORD  dwMessageId,  //错误代码
 8 
 9          DWORD  dwLanguageId,  //错误描述信息的语言
10 
11          PTSTR   pszBuffer,  //接收错误描述信息的输出缓冲区
12 
13          DWORD  nSize,//如果FORMAT_MESSAGE_FROM_ALLOCATE_BUFFER则这个参数设置以TCHARs为单位的输出缓冲区最小尺寸，不能大于64KB
14 
15          Va_list  *Argumentgs
16 
17 );
18 
19  
20 
21 //Eg.
22 
23 HLOCAL hLocal  = NULL;
24 
25 BOOL bRet = FormatMessage(FORMAT_MESSAGE_FROM_SYSTEM | FORMAT_MESSAGE_IGNORE_INSERTS | FORMAT_MESSAGE_ALLOCATE_BUFFER,
26 
27 NULL, dwError, MAKELANGID(LANG_NEUTRAL, SUBLANG_NEUTRAL),
28 
29 (PTSTR)&hLocal, 0, NULL
30 
31 );
32 
33  
34 
35 if(TRUE == bRet)
36 
37 {
38 
39          CString str(_T(“错误信息：”));
40 
41          AfxMessageBox(str + CString((LPWSTR)LocalLock(hLocal)) );  
44 
45          LocalFree(hLocal); 
47 }

 

 

 

3、定义自己的错误代码

1 VOID SetLastError(DWORD   dwErrCode);

 

关于DWORD表示的32位数中，从低位0---高位31位，

0—15位为MS/客户定义的代码；

16-27位中，前256个值由MS保留，剩余的供客户定义；

第28位必须为0，第29位为0表示MS定义的代码，为1表示客户定义的代码，这样保证MS和客户的定义的不会重复；

30—31中，0表示成功，1表示信息提示，2表示警告，3表示错误。

 

 

4、Visual Studio的工具菜单中一般都会有一个【错误查找】的命令，如果没有则到VS的开始菜单或者安装目录下查找这个工具，这个工具可以用来根据错误代码查找错误描述信息。