Windows 中的 HRESULT-Windows系列-PHP中文网

Windows 中的 HRESULT

蓮花仙者

发布： 2025-08-22 08:12:01

原创

488人浏览过

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

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

登录后复制

。

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

百度文心百中

百度大模型语义搜索体验中心

查看详情

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

以上就是Windows 中的 HRESULT的详细内容，更多请关注php中文网其它相关文章！