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

2023-11-12 01:52
文章标签 转换 错误码 win32 hresult

本文主要是介绍如何将一个 HRESULT 转换为 Win32 错误码?,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

地球人都知道,可以使用 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 代码;你不能只选一个。 让我们先展示下这个转换函数的代码。

>> 请移步至 topomel.com 以查看图片 <<

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

>> 请移步至 topomel.com 以查看图片 <<

因为 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 文件回归。这是版本冲突问题,但没有版本资源的好处。

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

>> 请移步至 topomel.com 以查看图片 <<

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

总结

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

最后

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

这篇关于如何将一个 HRESULT 转换为 Win32 错误码?的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/394292

相关文章

C#实现将Excel表格转换为图片(JPG/ PNG)

《C#实现将Excel表格转换为图片(JPG/PNG)》Excel表格可能会因为不同设备或字体缺失等问题,导致格式错乱或数据显示异常,转换为图片后,能确保数据的排版等保持一致,下面我们看看如何使用C... 目录通过C# 转换Excel工作表到图片通过C# 转换指定单元格区域到图片知识扩展C# 将 Excel

C++使用printf语句实现进制转换的示例代码

《C++使用printf语句实现进制转换的示例代码》在C语言中,printf函数可以直接实现部分进制转换功能,通过格式说明符(formatspecifier)快速输出不同进制的数值,下面给大家分享C+... 目录一、printf 原生支持的进制转换1. 十进制、八进制、十六进制转换2. 显示进制前缀3. 指

使用Python开发一个带EPUB转换功能的Markdown编辑器

《使用Python开发一个带EPUB转换功能的Markdown编辑器》Markdown因其简单易用和强大的格式支持,成为了写作者、开发者及内容创作者的首选格式,本文将通过Python开发一个Markd... 目录应用概览代码结构与核心组件1. 初始化与布局 (__init__)2. 工具栏 (setup_t

Java中Date、LocalDate、LocalDateTime、LocalTime、时间戳之间的相互转换代码

《Java中Date、LocalDate、LocalDateTime、LocalTime、时间戳之间的相互转换代码》:本文主要介绍Java中日期时间转换的多种方法,包括将Date转换为LocalD... 目录一、Date转LocalDateTime二、Date转LocalDate三、LocalDateTim

Python实现AVIF图片与其他图片格式间的批量转换

《Python实现AVIF图片与其他图片格式间的批量转换》这篇文章主要为大家详细介绍了如何使用Pillow库实现AVIF与其他格式的相互转换,即将AVIF转换为常见的格式,比如JPG或PNG,需要的小... 目录环境配置1.将单个 AVIF 图片转换为 JPG 和 PNG2.批量转换目录下所有 AVIF 图

详解如何通过Python批量转换图片为PDF

《详解如何通过Python批量转换图片为PDF》:本文主要介绍如何基于Python+Tkinter开发的图片批量转PDF工具,可以支持批量添加图片,拖拽等操作,感兴趣的小伙伴可以参考一下... 目录1. 概述2. 功能亮点2.1 主要功能2.2 界面设计3. 使用指南3.1 运行环境3.2 使用步骤4. 核

Java实现时间与字符串互相转换详解

《Java实现时间与字符串互相转换详解》这篇文章主要为大家详细介绍了Java中实现时间与字符串互相转换的相关方法,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录一、日期格式化为字符串(一)使用预定义格式(二)自定义格式二、字符串解析为日期(一)解析ISO格式字符串(二)解析自定义

在java中如何将inputStream对象转换为File对象(不生成本地文件)

《在java中如何将inputStream对象转换为File对象(不生成本地文件)》:本文主要介绍在java中如何将inputStream对象转换为File对象(不生成本地文件),具有很好的参考价... 目录需求说明问题解决总结需求说明在后端中通过POI生成Excel文件流,将输出流(outputStre

python+opencv处理颜色之将目标颜色转换实例代码

《python+opencv处理颜色之将目标颜色转换实例代码》OpenCV是一个的跨平台计算机视觉库,可以运行在Linux、Windows和MacOS操作系统上,:本文主要介绍python+ope... 目录下面是代码+ 效果 + 解释转HSV: 关于颜色总是要转HSV的掩膜再标注总结 目标:将红色的部分滤

利用Python开发Markdown表格结构转换为Excel工具

《利用Python开发Markdown表格结构转换为Excel工具》在数据管理和文档编写过程中,我们经常使用Markdown来记录表格数据,但它没有Excel使用方便,所以本文将使用Python编写一... 目录1.完整代码2. 项目概述3. 代码解析3.1 依赖库3.2 GUI 设计3.3 解析 Mark