Windows Programming/错误处理

在Windows API函数中，一般返回值类型为如下几种：

VOID，即C语言的void类型，表示该函数执行期间不会出任何错误，这种函数比较少；
BOOL，即C语言的int类型，返回TRUE(即1)表示函数执行期间没有错误，返回FALSE(即0)表示函数执行期间出现错误；
HANDLE，即C语言的void*，一般返回NULL表示函数执行有错误，有时也会返回一个INVALID_HANDLE_VALUE(即指向0xFFFFFFFF)，何时返回什么值文档中都有说明；
PVOID，即C语言的void*，返回NULL表示函数执行有错误；
LONG/DWOWD，即C语言里的long/unsigned int类型，这种类型的值比较难于处理，要严格按照文档说明进行判断，一般来说，返回0表示程序执行无误，否则需要根据返回值作具体判断

GetLastError函数是在程序调用Win32 API函数出现错误时，获取最后一次错误的编号，以便进一步确定具体错误原因。GetLastError函数返回一个整数，表示错误代码，每个代码的含义可以在头文件WinError.h中找到申明。

例子

#include <tchar.h>
#include <stdio.h>
#include <stdlib.h>
#include <locale.h>
#include <windows.h>
 
#define MAX_ERROR 512
 
int main(int argc, char* argv[])
{
	// 保存错误编号
	DWORD dwError = NO_ERROR;
   
	// 保存错误信息
	TCHAR szBuffer[MAX_ERROR] = TEXT("");
 
	// 保存文件句柄
	HANDLE hFile = INVALID_HANDLE_VALUE;
 
	// 调用C函数设置当前区域环境为中国
	_tsetlocale(LC_ALL, _T("zhi"));
 
	// 调用API打开一个文件(由于此文件不存在，所以该函数调用不成功)
	hFile = CreateFile(TEXT("c:/abc.dat"), 
		GENERIC_READ | GENERIC_WRITE, 
		FILE_SHARE_READ,
		NULL,
		OPEN_EXISTING,
		FILE_ATTRIBUTE_NORMAL,
		NULL
	);
 
	// 判断文件句柄是否有效，如无效，则调用GetLastError获取错误代码
	if (hFile == INVALID_HANDLE_VALUE) {
		dwError = GetLastError();
		_tprintf(_T("错误代码为: %d。/n"), dwError);
 
		// 根据GetLastError函数返回值判断错误原因
		if (dwError == ERROR_INVALID_NAME) {
			_tprintf(_T("错误代码显示错误原因为：文件名错误。/n"));
		}
	}
 
	if (dwError != NO_ERROR) {
		// 调用FormatMessage函数获取系统定义的错误信息
		DWORD nLen = FormatMessage(
			FORMAT_MESSAGE_FROM_SYSTEM | FORMAT_MESSAGE_IGNORE_INSERTS,    // 设置消息来自于系统且忽略插入词
			NULL,            // 设置消息源，函数可以通过这个消息源格式化错误信息，此处不使用消息源，所以设置为NULL
			dwError,        // 错误编号
			0,                // 语言信息，0表示使用系统默认语言
			szBuffer,        // 存放错误信息的缓冲区
			MAX_ERROR,        // 缓冲区长度(最大字数)
			NULL            // 用于格式化信息的参数，这里为NULL
		);
	   
		if (nLen > 0) {
			_tprintf(_T("系统提示错误信息为: %s"), szBuffer);
		} else {
			_tprintf(_T("无法获取错误信息。"));
		}
	}
 
	system("pause");
	return 0;
}

FormatMessage的用法

根据一个错误码返回一个错误讯息。

DWORD FormatMessage(
    DWORD dwFlags,
    LPCVOID lpSource,
    DWORD dwMessageId,
    DWORD dwLanguageId,
    LPTSTR lpBuffer,
    DWORD nSize,
    va_list* Arguments
    );

dwFlags:

FORMAT_MESSAGE_ALLOCATE_BUFFER // 此函数会分配内存以包含描述字串。
FORMAT_MESSAGE_FROM_SYSTEM, // 在系统的id映射表中寻找描述字串
FORMAT_MESSAGE_FROM_HMODULE // 在其他资源模块中寻找描述字串
FORMAT_MESSAGE_FROM_STRING // 消息ID是个字串，不是个DWORD

lpSource:

指定了FORMAT_MESSAGE_FROM_HMODULE的话，此参数表示模块的HANDLE
指定了FORMAT_MESSAGE_FROM_STRING的话，此参数表示id字串

通常为：NULL

dwMessageId: 消息ID;如果指定FORMAT_MESSAGE_FROM_STRING，将被忽略。

dwLanguageId: 消息描述所用的语言通常为：0表示自动选择

lpBuffer:

如果未指定FORMAT_MESSAGE_ALLOCATE_BUFFER，则为自己提供的缓冲区
否则为系统LocalAlloc分配，需要被用户LocalFree

nSize:

如果未指定FORMAT_MESSAGE_ALLOCATE_BUFFER，则为自己提供的缓冲区大小
否则为系统LocalAlloc分配之最小缓冲区大小

Arguments: 通常不使用