函数错误处理一（总结自windows编程核心）

1. /*
2.     Error Handling Part 1
4.     当我们调用Windows函数的时候，函数会验证我们给它传递的参数，如果参数不
5.     正确或由于其它一些原因函数没能正确执行，则函数会以返回值的形式告诉调用
6.     者函数出错了。
8.     常见的返回值：
10.     VOID：
11.         这种函数值说明函数不可能出错，只有极少数的Windows函数不会出错。
12.     BOOL：
13.         函数失败时返回0，成功时返回非0。所以我们检查函数是否成功时要避免
14.         看返回值是否等于TRUE，而是要看返回值是否不等于FALSE。
15.     HANDLE：
16.         失败时通常为NULL，否则就返回一个我们可以使用对象的句柄。
17.         需要注意的是，有些函数会返回INVALID_HANDLE_VALUE即-1，对于这种情况，
18.         需要查看MSDN以确定是NULL代表失败还是INVALID_HANDLE_VALUE代表失败。
19.     PVOID：
20.         失败时返回NULL，否则就返回一个数据块的内存地址。
21.     LONG/DWORD：
22.         这类返回值比较严格。函数的作用一般是检查指定对象的数目。由于一些原因，
23.         如果函数不能检查出指定对象的具体数目，则通常会返回0或-1，此时我们
24.         就需要查看资料以明确哪种方式代表函数执行失败。
25. */
26. //
27. // MessageId: ERROR_INVALID_FUNCTION
28. //
29. // MessageText:
30. //
31. // Incorrect function.
32. //
33. #define ERROR_INVALID_FUNCTION          1L // dderror
34. //
35. /*
36.     如果函数失败而我们也想知道失败的原因，可以在失败的函数后立即调用函数
37.     GetLastError，记住是立即调用，不然如果你在期间又调用了其它函数，失败
38.     函数的错误码可能会被覆盖。
40.     一个错误码的格式如上所示，其由三部分组成，一个标识符，一个英文描述和
41.     一个数值。
43.     GetLastError不仅可以告诉编程人员函数出错的原因，而且也可以告诉编程人员
44.     函数成功执行的原因，因为一个函数的成功执行可能是由多个原因中的一个导致
45.     的。这时候我们调用GetLastError，它就会给我们返回成功的具体原因。
46. */
48. /*
49.     在调试代码的时候，我们可以配置Visual Studio时刻显示当前线程的最后错误码
50.     及其描述，配置方式就是调用窗口的Watch窗口中的任一行输入$err,hr，具体效果
51.     可参考图一。
52.     另外,VS也提供了一个小功能Error Lookup，通过它，我们输入错误友就可以看到
53.     错误的描述。具体可参考图二。
54. */