【WIN32之旅】WINDOWS错误处理与参考(三)

最新推荐文章于 2022-03-17 15:57:02 发布

TZSEVEN

最新推荐文章于 2022-03-17 15:57:02 发布

阅读量3.5k

点赞数 1

CC 4.0 BY-SA版权

分类专栏： WINDOWS 编程文章标签：计算机编程 windows api

本文链接：https://blog.youkuaiyun.com/seven_1992/article/details/44487785

本文介绍了在Windows编程中处理错误的API，包括GetLastError()和SetLastError()用于获取和设置错误代码，以及FormatMessage()函数用于格式化错误信息。通过示例展示了如何使用这些函数来理解和解析错误代码。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

转载请说明原出处，谢谢~ http://blog.youkuaiyun.com/seven_1992/article/details/44487785

在WINDOWS编程中，我们在所难免会与“错误”打交道，但令我们“找不着北”的是，我们不知道是什么错误（What's Error?），亦或者是系统给出了错误代码(Error Code)，而我们却郁闷着怎么没有详细的错误信息（Error Information），这样一个错误代码到底要表达什么意思（What's mean?）。接下来要登场的就是几个与错误信息有关的系统API函数了，关于错误信息的处理与参考，下面就让我们来看看这几个函数吧。

一、设置和获取错误代码

当我们在代码运行的过程中，发生了错误，要获取或者设置错误信息，我们就要用到两个与此相关的函数 GetLastError()与SetLastError(),可以看出，这是一对兄弟函数(Sibling Function），函数的命名总是这样，Get函数与Set函数总是成对出现，其实在我们平时与代码打交道的日子里算是家常了，关于这两个函数我们接下来就先来了解一下吧。

1、GetLastError()函数：

DWORD WINAPI GetLastError(void); // 获取最后一次错误代码

这是MSDN上函数的原型，返回值为DWORD(双字型)，函数调用约定为宏WINAPI(即__stdcall标准调用),输入参数为void(空参数型)，MSDN上对该函数的解释是：获取该调用线程的最后一次错误错代码，该错误代码是基于线程的，多线程中各自线程的错误代码是独立而不相互覆盖的（简而言之，错误代码是线程级别拥有的，你使用该函数获取到的错误代码是该线程的）。

2、SetLastError()函数：

void WINAPI SetLastError(_In_ DWORD dwErrCode);  // 设置错误代码

顾名思义，这个函数的作用也就是设置最后一次出错代码（Last-error Code），其实理解了它的兄弟函数GetLastError()的，我想对于这个函数的理解和运用也就不是那么难了。（同样，该函数设置的错误代码也是线程级别的）

对于SetLastError()函数，同样有着一个扩展函数（Extension Function）：

void WINAPI SetLastErrorEx(
  _In_  DWORD dwErrCode,
  _In_  DWORD dwType
);

MSDN目前给出的解释是：目前，由于第二个参数暂时被忽略，该函数等同于SetLastError()。

PS. 关于错误代码（Error Code），MSDN上还有这样一段注释：

错误代码是一个32位值，最高位也就是第31位是最重要的一位。第29位是专门用来给应用程序定义错误的（非系统错误该位必须设置），如果你要给应用程序定义错误，请设置此位为1，以表明该错误代码是由应用程序定义的。你需要保证你定义的错误代码不与系统定义的错误代码相冲突。

二、格式化错误信息

当然我们会说，GetLastError()与SetLastError()两个函数也就是设置和获取错误代码，而既然是代码，我怎么知道这代码要表达的是什么意思？没关系，接下来要登场的就是我们的FormatMessage()函数：

    DWORD WINAPI FormatMessage(     // 返回值DWORD是消息格式化后的长度
    _In_      DWORD dwFlags,        // 格式化选项标志，以及说明如何解释lpSource
    _In_opt_  LPCVOID lpSource,     // 格式化消息串的源（由dwFlags选项决定）