0

0

Windows 中的 HRESULT

蓮花仙者

蓮花仙者

发布时间:2025-08-22 08:12:01

|

508人浏览过

|

来源于php中文网

原创

windows 协议文档中,错误码使用 hresult、win32 错误码和 ntstatus 来描述。让我们来详细了解一下 hresult。

首先,我们举一个常见的 HRESULT 例子,以便后续介绍更易理解。

1 0x80070070 将其转换为二进制形式: 1 1000 0000 0000 0111 0000 0000 0111 0000 这个错误码表示的意思是:“There is not enough space on the disk.”,即“磁盘空间不足”。

根据规范,HRESULT 的格式如下,首行的数字代表第几位(bit):

0 1 2 3 4 5~15 16~31 S

R

C

N

X

Facility

Code

S: 1 位,表示严重性。为 1 表示此结果为失败,为 0 表示此结果为成功。R: 1 位,保留位。如果 N 位是 0,那么此位必须也是 0。如果 N 位是 1,那么此位由 NTSTATUS 定义的数字范围决定。C: 1 位,自定义位。为 1 表示由微软定义,为 0 表示由其他厂商定义。N: 1 位。为 1 表示此结果为 NTSTATUS 错误码。X: 1 位。保留位,应设为 0。Facility: 11 位。设施代码。指定错误来源。后面的列表中有已定义的错误源,微软偶尔会添加新的种类。Code: 16 位(2 字节)。错误码的其他部分,指定错误的具体细节。Facility 设施代码的详细列表可以参考这里:[MS-ERREF]: HRESULT - Microsoft Docs。对于 Win32 开发来说,0x7 是很常见的,表示

FACILITY_WIN32

现在让我们再看一下前面的例子:

SnapEdit
SnapEdit

AI移除图片中的任何物体

下载
1 1000 0000 0000 0111 0000 0000 0111 0000 严重性:1,表示失败设施代码:0x7,表示 `FACILITY_WIN32`错误码:0x70,表示 `ERROR_DISK_FULL`所有的 Win32 错误码应该仅使用 16 位来表示,即范围从 0x0000 到 0xFFFF。关于 Win32 错误码的详细列表可以参考这里:\[MS-ERREF\]: Win32 Error Codes - Microsoft Docs。

如果你遇到了某个 Win32 错误码或者 HRESULT 值,可以使用微软错误查询工具(The Microsoft Error Lookup Tool)来查询其含义。

下载地址:Download Microsoft Error Lookup Tool from Official Microsoft Download Center

Windows 中的 HRESULT

在 .NET/C# 代码中,我们可能需要处理磁盘空间已满的情况,例如在一些 IO 操作中:

123456789101112 try{ SaveFile(fileContent, filePath);}catch (IOException ex){ if (ex.IsDiskFullException()) { // 磁盘空间已满。 break; }} 由于磁盘空间已满没有对应的 .NET Exception,我们只能通过提取 `IOException` 中的 `HResult` 属性来判断操作的 HRESULT 值。

我们定义了一个扩展方法

IsDiskFullException
,实现如下:

12345678910111213141516 /// /// There is not enough space on the disk./// 磁盘空间不足。/// private static readonly int ERROR\_DISK\_FULL = 0x0070;/// /// 判断某个 是否是“磁盘空间不足”的异常。/// /// IO 异常。/// public static bool IsDiskFullException(this IOException ex){ var errorCode = ex.HResult & 0xFFFF; return errorCode == ERROR\_DISK\_FULL;}

参考资料

MS-ERREF: HRESULT - Microsoft DocsHRESULT - 维基百科,自由的百科全书The Microsoft Error Lookup Tool - Win32 apps - Microsoft Docs 本文会经常更新,请阅读原文: https://www.php.cn/link/1cbb2344a50511f9ea581e66c5cc54f7 ,以避免陈旧错误知识的误导,同时有更好的阅读体验。

本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。欢迎转载、使用、重新发布,但务必保留文章署名 吕毅 (包含链接: https://www.php.cn/link/8c3af53f6554ac306d481a872a47fb83 ),不得用于商业目的,基于本文修改后的作品务必以相同的许可发布。如有任何疑问,请 与我联系 ([email protected]) 。

相关专题

更多
html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

616

2023.06.14

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

658

2023.06.21

html网页制作
html网页制作

html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

471

2023.07.31

html空格
html空格

html空格是一种用于在网页中添加间隔和对齐文本的特殊字符,被用于在网页中插入额外的空间,以改变元素之间的排列和对齐方式。本专题为大家提供html空格的相关的文章、下载、课程内容,供大家免费下载体验。

245

2023.08.01

html是什么
html是什么

HTML是一种标准标记语言,用于创建和呈现网页的结构和内容,是互联网发展的基石,为网页开发提供了丰富的功能和灵活性。本专题为大家提供html相关的各种文章、以及下载和课程。

2898

2023.08.11

html字体大小怎么设置
html字体大小怎么设置

在网页设计中,字体大小的选择是至关重要的。合理的字体大小不仅可以提升网页的可读性,还能够影响用户对网页整体布局的感知。php中文网将介绍一些常用的方法和技巧,帮助您在HTML中设置合适的字体大小。

507

2023.08.11

html转txt
html转txt

html转txt的方法有使用文本编辑器、使用在线转换工具和使用Python编程。本专题为大家提供html转txt相关的文章、下载、课程内容,供大家免费下载体验。

312

2023.08.31

html文本框代码怎么写
html文本框代码怎么写

html文本框代码:1、单行文本框【<input type="text" style="height:..;width:..;" />】;2、多行文本框【textarea style=";height:;"></textare】。

426

2023.09.01

菜鸟裹裹入口以及教程汇总
菜鸟裹裹入口以及教程汇总

本专题整合了菜鸟裹裹入口地址及教程分享,阅读专题下面的文章了解更多详细内容。

0

2026.01.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 7.6万人学习

Excel 教程
Excel 教程

共162课时 | 13万人学习

PHP基础入门课程
PHP基础入门课程

共33课时 | 2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号