如何将一个 HRESULT 转换为 Win32 错误码?

如何将一个 HRESULT 转换为 Win32 错误码?

作者:BlogUpdater |  时间:2023-11-11 |  浏览:264 |  评论已关闭 条评论

地球人都知道,可以使用 HRESULT_FROM_WIN32 这个宏将一个 Win32 错误码转换为一个 HRESULT,但是如何将一个 HRESULT 转换为 Win32 错误码呢?

让我们先看看 HRESULT_FROM_WIN32 这个宏的定义:

=============================================================
#define HRESULT_FROM_WIN32(x) \
((HRESULT)(x) <= 0 ? ((HRESULT)(x)) \
: ((HRESULT) (((x) & 0x0000FFFF) | (FACILITY_WIN32 << 16) | 0x80000000)))
=============================================================

如果传入宏的值小于等于零,则它将不会做任何修改,否则,它会取值的低 16 位,然后和 FACILITY_WIN32 和 SEVERITY_ERROR 合并。

我们应该如何反转这个逻辑,编写一个 WIN32_FROM_HRESULT 宏呢?

首先,我们看起来不可能编写这样一个宏,因为 HRESULT_FROM_WIN32 函数提供的映射不是一对一的。
如果正确的实现了这个宏,则我们将会得到一条将 0 映射到 S_OK 的单独算法,以及将 65536 错误代码的块映射到同一 HRESULT 空间的一系列块。

请注意,范围 1 到 0x7FFFFFFFF 中的值是 HRESULT_FROM_WIN32 宏的不可能结果。此外,0x80070000 到 0x8007FFFF 范围内的值可能来自相当多的原始 Win32 代码;你不能只选一个。

让我们先展示下这个转换函数的代码。

当然,我们本来可以写的更简单一点。

因为 HRESULT_FROM_WIN32 宏是幂等的:HRESULT_FROM_WIN32(HRESULT_FROM_WIN32(x)) == HRESULT_FROM_WIN32(x)。因此,如果你声明“反向”函数是微不足道的,那么在技术上是正确的。但在实践中,人们想尝试把“x”找回来,这就是我们给你的。

现在,你已经了解了 HRESULT_FROM_WIN32 宏的工作原理,我们可以根据实际的客户问题来回答以下问题:

====================================================
有时,当我从扫描仪导入数据时,会出现错误“无法删除目录”。这是什么意思?
====================================================

你将不得不使用一些精神力量来调试这个问题,但我认为你已经做到了。

HRESULT 和 Win32 错误代码的一个不幸方面是,没有包含所有错误的单个头文件。从逻辑的角度来看,这是可以理解的:

多个团队需要为其组件编造新的错误代码,但 winerror.h 文件由内核团队维护。如果选择 winerror.h 作为所有错误代码的主存储库,则意味着任何想要添加新错误代码或更改现有错误代码的团队都必须缠着内核团队为他们进行更改。

如果这些团队有自己的 SDK,事情就会变得更加复杂。例如,假设 DirectX 和 Windows Media 团队都希望在其相应的 SDK 中包含新的 winerror.h。如果以错误的顺序安装 SDK(以及如何知道应该先安装哪个,DirectX 8 还是 WMSDK 6?),则最终可能会使 winerror.h 文件回归。这是版本冲突问题,但没有版本资源的好处。

许多团队已经说服了内核团队,为他们保留了一大块错误代码。

只有 65535 个 Win32 错误代码的空间,其中超过八分之一已经被这些“块分配”所淘汰。我想知道我们最终是否会因为错误代码太大而过早地用完错误代码。(这里可以与IPv4进行某种类比,但我不打算尝试。)

总结
我一直希望通过定义单个头文件来汇总所有的错误代码,但随着程序组件的越来越多,这个想法导致组件间的依赖性与日俱增,所以,我的做法是:回归到原始的错误字符串来报告错误,这样,各组件之间的错误代码就不会互相依赖和冲突了。

最后

Raymond Chen的《The Old New Thing》是我非常喜欢的博客之一,里面有很多关于Windows的小知识,对于广大Windows平台开发者来说,确实十分有帮助。
本文来自:《How do I convert an HRESULT to a Win32 error code?》

最近我写了个东西

正如你们所知道的,拓扑梅尔智慧办公平台(Topomel Box)是一款绿色软件,主要面向经常使用电脑的朋友。它提供了各种提升办公效率的小功能,同时操作上尽可能地简单方便。
我想:你值得拥有。

评论已关闭。