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

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

AI Web Designer
AI Web Designer

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]) 。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
if什么意思
if什么意思

if的意思是“如果”的条件。它是一个用于引导条件语句的关键词,用于根据特定条件的真假情况来执行不同的代码块。本专题提供if什么意思的相关文章,供大家免费阅读。

847

2023.08.22

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

492

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

382

2023.10.25

java中break的作用
java中break的作用

本专题整合了java中break的用法教程,阅读专题下面的文章了解更多详细内容。

120

2025.10.15

java break和continue
java break和continue

本专题整合了java break和continue的区别相关内容,阅读专题下面的文章了解更多详细内容。

261

2025.10.24

java中break的作用
java中break的作用

本专题整合了java中break的用法教程,阅读专题下面的文章了解更多详细内容。

120

2025.10.15

java break和continue
java break和continue

本专题整合了java break和continue的区别相关内容,阅读专题下面的文章了解更多详细内容。

261

2025.10.24

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1051

2023.08.02

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

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

精品课程

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

共48课时 | 10.6万人学习

Excel 教程
Excel 教程

共162课时 | 21.3万人学习

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

共33课时 | 2.3万人学习

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

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