### WINDOWS核心编程001 —— 错误处理机制详解
#### 一、引言
在深入探索Microsoft Windows操作系统的核心编程技术之前，错误处理是一个必不可少的话题。本章节将重点介绍如何在Windows应用程序中有效地处理错误，包括理解Windows函数的错误返回机制、如何获取和解析错误代码，以及如何在实际开发过程中运用这些知识。
#### 二、Windows函数的错误处理
在编写Windows应用程序时，了解函数如何处理错误是非常重要的。通常情况下，当调用一个Windows函数时，系统会首先检查传入参数的有效性，然后尝试执行指定的任务。如果参数无效或因其他原因导致任务无法完成，函数将返回一个特定值来指示失败情况。
**表1-1 Windows函数常用的返回值类型**
| 数据类型 | 表示失败的值 |
|----------|-------------|
| `VOID` | 函数运行不可能失败。Windows函数的返回值类型很少是`VOID`。 |
| `BOOL` | 如果函数运行失败，那么返回值是0，否则返回的是非0值。最好对返回值进行测试，以确定它是0还是非0。不要测试返回值是否为`TRUE`。 |
| `HANDLE` | 如果函数运行失败，则返回值通常是`NULL`，否则返回值为`HANDLE`，用于标识你可以操作的一个对象。注意，有些函数会返回一个句柄值`INVALID_HANDLE_VALUE`，它被定义为-1。 |
| `PVOID` | 如果函数运行失败，则返回值是`NULL`，否则返回`PVOID`，以标识数据块的内存地址。 |
| `LONG`/`DWORD` | 这是个难以处理的值。返回数量的函数通常返回`LONG`或`DWORD`。如果由于某种原因，函数无法对想要进行计数的对象进行计数，那么该函数通常返回0或-1（根据函数而定）。 |
#### 三、错误代码及其获取
**32位错误代码**
一个Windows函数返回的错误代码对于理解函数为何失败非常有用。Microsoft公司编译了一个所有可能的错误代码列表，并为每个错误代码分配了一个32位的号码。当一个Windows函数检测到错误时，它会使用线程本地存储器(thread-local storage)的机制，将相应的错误代码与调用线程关联起来。这样可以确保线程能够独立运行，而不会影响其他线程的错误代码。
为了获取错误代码，可以调用`GetLastError`函数，该函数返回当前线程的32位错误代码。
**WinError.h头文件**
当你获得了32位错误代码后，需要将其转换为更有意义的信息。`WinError.h`头文件包含了Microsoft定义的所有错误代码的列表。例如：
```cpp
#define ERROR_SUCCESS 0L
#define ERROR_INVALID_FUNCTION 1L
#define ERROR_FILE_NOT_FOUND 2L
...
```
每个错误都有三种表示方式：一个消息ID（可以在源代码中使用的宏，以便与`GetLastError`的返回值进行比较），消息文本（对错误的英文描述）和一个数字编号（建议避免直接使用编号，而是使用消息ID）。
#### 四、注意事项
1. **立即调用`GetLastError`**
- 当Windows函数运行失败时，应立即调用`GetLastError`函数。如果调用其他Windows函数，其值可能会被覆盖。
2. **`GetLastError`的行为**
- `GetLastError`返回线程产生的最后一个错误。即使函数运行成功，最后一个错误代码也不会被清除。只有少数Windows函数在成功运行时会更新最后的错误代码。
3. **Windows 98的特殊考虑**
- 许多Windows 98的函数实际上是由16位Windows 3.1产品的旧代码实现的。这些较老的代码不通过`GetLastError`这样的函数报告错误。因此，在Windows 98中，许多Win32函数在运行失败时可能不会返回错误代码。
#### 五、总结
错误处理是Windows应用程序开发中不可或缺的一部分。通过深入了解Windows函数的错误返回机制、如何获取和解析错误代码，开发者可以更好地理解和解决程序中遇到的问题。此外，掌握这些知识还可以帮助提高程序的健壮性和用户友好性。
