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:

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

lpSource:

  1. 指定了FORMAT_MESSAGE_FROM_HMODULE的话,此参数表示模块的HANDLE
  2. 指定了FORMAT_MESSAGE_FROM_STRING的话,此参数表示id字串

通常为:NULL

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

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

lpBuffer:

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

nSize:

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

Arguments: 通常不使用