【Windows 核心编程】Windows 核心编程 -- 错误处理

一，常见的Windows函数返回值类型

1）VOID：这个函数不可能失败，极少数Windows函数的返回值类型为VOID。

VOID ExitProcess(UINT uExitCode);

2）BOOL：如果函数失败，返回值为0；否则，返回值是一个非0值。应避免测试返回值是否为TRUE，应该检查是否不为FALSE。

BOOL TerminateProcess(HANDLE hProcess, UINT uExitCode);

为什么不能使用if (result == TRUE)，而要使用if (result != FALSE)。从反汇编代码的效率以及指令长度上没有什么区别。

但是主要在0、1的判断，0是单独个体，但是1需要理解为非0就对了，但是机器只是跟1来比较，所以缩小了范围。

3）HANDLE：如果函数失败，返回值通常为NULL；否则HANDLE将标识一个可以操作的对象。但是有时候失败的时候返回的值为INVALID_HANDLE_VALUE，被定义为-1。

HANDLE OpenProcess(DWORD dwDesiredAccess, BOOL bInheritHandle, DWORD dwProcessId);

4）PVOID：如果函数调用失败，则返回值为NULL；否则PVOID将标识一个数据块的内存地址

5）LPVOID HeapAlloc(HANDLE hHeap, DWORD dwFlags, SIZE_T dwBytes);

6） LONG/DWORD：返回具体的LONG/DWORD数值，需要根据MSDN的提示进行正确判断。

7）DWORD GetCurrentProcessId(VOID);

二，函数错误返回码

Windows函数检测到错误的时候，它会使用一种名为“线程本地存储区”的机制将相应的错误代码与调用线程关联到一起，使得不同线程的错误代码不互相干扰。

GetLastError()

此函数的作用很简单，就是返回由上一个函数调用设置的线程的32位错误码。WinError.h头文件包含了MiscrSoft定义的错误代码列表。

Windows函数调用失败之后，要马上调用该函数，不然可能在调用了另一个Windows函数后，LastError将会被改写（Windows函数调用成功以后可能会把此值改写成ERROR_SUCCESS）。

之前见过一下两种方法，使用GetLastError()，都应该在后续编程时尽量将程序的容错性、健壮性提高。

代码 1：

if (!WriteFile(hFile, lpBuffer, strlen(lpBuffer), &dwWritten, NULL))
{
                 return   GetLastError( );
 }   

代码 2：

switch (GetLastError())
{
case ERROR_IO_PENDING:
    //...
    break;
case ERROR_PIPE_CONNECTED:
    //...
    break;
default:
    {
        printf("Connent Namepipe failed with %d.\n", GetLastError());
        return 0;
    }
} 

代码 3：

      if(ERROR_INSUFFICIENT_BUFFER == GetLastError())
    {
           lpDeviceInterfaceDetailData = HeapReAlloc(
                             GetProcessHeap(), 0, 
                            lpDeviceInterfaceDetailData, dwBufferSize);
        
           lpDeviceInterfaceDetailData->cbSize 
                           = sizeof(SP_DEVICE_INTERFACE_DETAIL_DATA);
    }  

三，定义自己的错误代码

1）对于自己写的函数也可以通过API设置错误号，增强健壮性，使用SetLastError()，便可以修改错误号，不过为了通用，对于设置错误代码尽量使用WinError.h中的。也可以自己设置新的错误编号。

VOID SetLastError(DWORD dwErrCode)

32位错误代码

四，VS的Debug调试信息

在VS的Watch窗口中，添加$err,hr就可以显示函数错误返回码和相关提示语句，已经错误提示。VC6不支持。

五，ErrorShow程序

FormatMessage( ) //将GetLastError得到的错误信息（这个错误信息是数字代号）转化成字符串信息的函数

1）函数原型：

DWORD WINAPI FormatMessage(
　　__in DWORD dwFlags, //标志位，决定如何说明lpSource参数
　　__in_opt LPCVOID lpSource,
　　__in DWORD dwMessageId, //请求的消息的标识符。当dwFlags标志为FORMAT_MESSAGE_FROM_STRING时会被忽略
　　__in DWORD dwLanguageId, //请求的消息的语言标识符
　　__out LPTSTR lpBuffer, //缓存区保存格式化消息，通过lpBuffer 指向首地址
　　__in DWORD nSize, //如果FORMAT_MESSAGE_ALLOCATE_BUFFER标志没有被指定，这个参数必须指定为输出缓冲区的大小
　　__in_opt va_list *Arguments //　保存格式化信息中的插入值的一个数组。
　　);

返回值：

　　如果函数调用成功，返回输出缓冲区的大小，除最后一个空字符。如果失败侧返回0。

2）代码示例：

#include <stdio.h>
#include <windows.h>
int main()
{
    DWORD dwError = 0;
    printf("请输入要查询的错误代码：");
    scanf("%d", &dwError);

    HLOCAL hLocal = NULL;
    DWORD SystemLocale = MAKELANGID(LANG_NEUTRAL, SUBLANG_NEUTRAL);
    BOOL bOk = FormatMessage(FORMAT_MESSAGE_FROM_SYSTEM | FORMAT_MESSAGE_IGNORE_INSERTS | FORMAT_MESSAGE_ALLOCATE_BUFFER,
                             NULL,
							 dwError,   //请求的消息的消息标识符
							 SystemLocale,  //语言标识符
							 (PTSTR)&hLocal, //缓冲区保存格式化消息，并且通过lpBuffer指向该地址。
							 0,
							 NULL);
	if(hLocal!=NULL)
	{
		MessageBox(NULL,(PCTSTR)LocalLock(hLocal),L"Title(错误内容)",MB_OK);
       // LocalLock(hLocal);
	}
    printf("查询失败：没有对应错误代码\n");

	getchar();
    return -1;
}