HRESULT返回值说明

最新推荐文章于 2024-01-19 16:34:30 发布
最新推荐文章于 2024-01-19 16:34:30 发布 · 235 阅读 · 0
文章标签：

#VC++ #Windows

HRESULT返回值说明 如果函数正常执行，则返回 S_OK，同时真正的函数运行结果则通过参数指针返回。如果遇到了异常情况，则COM系统经过判断，会返回相应的错误值。

HRESULT         值          含义
S_OK            0x00000000  成功
S_FALSE         0x00000001  函数成功执行完成，但返回时出现错误
E_INVALIDARG    0x80070057  参数有错误
E_OUTOFMEMORY   0x8007000E  内存申请错误
E_UNEXPECTED    0x8000FFFF  未知的异常
E_NOTIMPL       0x80004001  未实现功能
E_FAIL          0x80004005  没有详细说明的错误。一般需要取得 Rich Error 错误信息(注1)
E_POINTER       0x80004003  无效的指针
E_HANDLE        0x80070006  无效的句柄
E_ABORT         0x80004004  终止操作
E_ACCESSDENIED  0x80070005  访问被拒绝
E_NOINTERFACE   0x80004002  不支持接口

HRESULT 其实是一个双字节的值，其最高位(bit)如果是0表示成功，1表示错误。具体参见 MSDN 之"Structure of COM Error Codes"说明。我们在程序中如果需要判断返回值，则可以使用比较运算符号；switch开关语句；也可以使用VC提供的宏：
     HRESULT hr = 调用组件函数;
      if( SUCCEEDED( hr ) ){...} // 如果成功
      ......
      if( FAILED( hr ) ){...} // 如果失败
      ......

大多数 COM 函数以及一些接口成员函数的返回值类型均为 HRESULT 类型。HRESULT 类型的返回值反映了函数中的一些情况，其类型定义规范如下：

   31 30 29 28                    16 15                                0
  |-----|--|------------------------|-----------------------------------|

类别码 (30-31) 反映函数调用结果：
                00 调用成功
                01 包含一些信息
                10 警告
                11 错误
自定义标记(29) 反映结果是否为自定义标识，1 为是，0 则不是；
操作码 (16-28) 标识结果操作来源，在 Windows 平台上，其定义如下：
                #define FACILITY_WINDOWS         8
                #define FACILITY_STORAGE         3
                #define FACILITY_RPC             1
                #define FACILITY_SSPI            9
                #define FACILITY_WIN32           7
                #define FACILITY_CONTROL         10
                #define FACILITY_NULL            0
                #define FACILITY_INTERNET        12
                #define FACILITY_ITF             4
                #define FACILITY_DISPATCH        2
                #define FACILITY_CERT            11
操作结果码(0-15) 反映操作的状态，WinError.h 定义了 Win32 函数所有可能返回结果。
                以下是一些经常用到的返回值和宏定义：
                S_OK            函数执行成功，其值为 0 (注意，其值与 TRUE 相反)
                S_FALSE         函数执行成功，其值为 1
                S_FAIL          函数执行失败，失败原因不确定
                E_OUTOFMEMORY   函数执行失败，失败原因为内存分配不成功
                E_NOTIMPL       函数执行失败，成员函数没有被实现
                E_NOTINTERFACE  函数执行失败，组件没有实现指定的接口

不能简单地把返回值与 S_OK 和 S_FALSE 比较，而要用 SECCEEDED 和 FAILED 宏进行判断。

HRESULT 函数返回值详细介绍
黑色幽灵的专栏
03-27 9995
HRESULT 值 含义 S_OK 0x00000000 成功 S_FALSE
VC/MFC HRESULT 类型 HRESULT 类型返回值正确判断方法
Kim的博客
10-11 573
// 等于 0 表示成功，小于 0 表示失败, 大于 0 的值表示有其它错误, // S_OK、S_FALSE 都表示成功
HRESULT 数据类型和显示错误信息
weixin_30528371的博客
06-06 683
HRESULT What we should know about HRESULT ? - HRSULT is a kind of Data Type ( Long 32bit) which is used for Windows. - It is The return codes used by COM interfaces. - To test an HRESULT value, u...
c# 打包出现HRESULT = '80040155' 错误 解决办法
sanjin240的专栏
01-20 784
当你安装了InstallField 而后来又删除了，就会出现此错误 解决方法：建一个.reg文件，写入 REGEDIT4 [HKEY_CLASSES_ROOT/Interface/{00020404-0000-0000-C000-000000000046}] @="IEnumVARIANT" [HKEY_CLASSES_ROOT/Interface/{00020404-0000-0
C# System.IO.IOException HResult=0x8007000D Message=数据无效。解决办法
weixin_43727933的博客
03-07 2378
System.IO.IOException HResult=0x8007000D Message=数据无效。解决办法 HResult=0x8007000D Message=数据无效。解决办法) 笔者在调试串口时遇到一个奇怪的错误。错误详细信息如下： 下面展示一些 内联代码片。 System.IO.IOException HResult=0x8007000D Message=数据无效。 Source=VehicleCollector StackTrace: at Vehicle
C# winform 对COM组件的调用返回了错误 HRESULT E_FAIL
曾经的我也很优秀，现在的我一无所有。
01-19 1274
要在加载设计器前避免可能发生的数据丢失，必须纠正以下错误： 对COM组件的调用返回了错误 HRESULT E_FAIL。
继续添加添加错误处理（通过HRESULT返回值） 实现参数验证机制 增加调试日志输出 完善内存管理（特别是图像数据传输）功能模块框架
03-13
用户提到要通过HRESULT返回值来处理错误。这意味着每个方法在实现时都需要检查可能的错误，并返回适当的HRESULT值。比如，如果参数无效，应该返回E_INVALIDARG，内存不足返回E_OUTOFMEMORY等。我需要考虑哪些地方...
HRESULT错误检查简化器
04-08
标题中的“HRESULT错误检查简化器”是一个专门针对HRESULT值进行错误检查的工具或技术，它旨在简化在C++编程中处理HRESULT返回值的过程。HRESULT是Windows API和其他COM接口广泛使用的错误代码类型，用来报告操作...
#define _WINSOCKAPI_ // 防止 Windows Sockets API 被重复定义 #include <windows.h> #include <sal.h> #include <httpserv.h> #include <stdio.h> // 定义主模块类，继承自 IHttpModule class CHelloWorld : public CHttpModule { public: // 请求开始时触发的方法 REQUEST_NOTIFICATION_STATUS OnBeginRequest( IN IHttpContext* pHttpContext, IN IHttpEventProvider* pProvider ) { // 忽略未使用的参数以避免编译警告 UNREFERENCED_PARAMETER(pProvider); // 用于存储方法调用的 HRESULT 返回值 HRESULT hr; // 获取当前 HTTP 请求的响应对象 IHttpResponse* pHttpResponse = pHttpContext->GetResponse(); // 获取当前 HTTP 请求对象 IHttpRequest* pHttpRequest = pHttpContext->GetRequest(); // 分配一块 512 字节的内存用于后续操作 PCSTR pszBuffer = (PCSTR)pHttpContext->AllocateRequestMemory(512); // 获取原始 HTTP 请求结构体指针 HTTP_REQUEST* prawRequest = pHttpRequest->GetRawHttpRequest(); // 提取请求 URL 的原始字符串 PCSTR Url = prawRequest->pRawUrl; // 判断响应对象是否有效 if (pHttpResponse != NULL) { // 获取端口 //USHORT port = ((in_addr*)(prawRequest->Address.pLocalAddress))->s_host; // 注意：端口是网络字节序，需要转换为主机字节序 //port = ntohs(port); // 清除现有响应内容 pHttpResponse->Clear(); // 设置响应头 Content-Type 为 text/plain pHttpResponse->SetHeader( HttpHeaderContentType, "text/plain", (USHORT)strlen("text/plain"), TRUE ); // 准备要发送给客户端的文本数据 PCSTR pszBuffer = "Hello World!: OnBeginRequest"; // 定义一个 HTTP 数据块结构体 HTTP_DATA_CHUNK dataChunk; // 设置数据块类型为内存块 dataChunk.DataChunkType = HttpDataChunkFromMemory; // 定义变量用于接收实际写入字节数 DWORD cbSent; // 设置数据块的内存地址 dataChunk.FromMemory.pBuffer = (PVOID)pszBuffer; // 设置数据块长度 dataChunk.FromMemory.BufferLength = (USHORT)strlen(pszBuffer); // 将数据块写入 HTTP 响应流中 hr = pHttpResponse->WriteEntityChunks( &dataChunk, 1, FALSE, TRUE, &cbSent, FALSE ); // 判断写入是否成功 if (FAILED(hr)) { // 若失败，则设置 HTTP 状态码为 500 内部服务器错误 pHttpResponse->SetStatus(500, "Server Error", 0, hr); } // 结束请求处理流程 return RQ_NOTIFICATION_FINISH_REQUEST; } // 继续执行其他请求处理逻辑 return RQ_NOTIFICATION_CONTINUE; } }; // 定义模块工厂类，用于创建模块实例 class CHelloWorldFactory : public IHttpModuleFactory { public: // 获取 HTTP 模块实例的方法 HRESULT GetHttpModule( OUT CHttpModule** ppModule, IN IModuleAllocator* pAllocator ) { // 忽略未使用的参数 UNREFERENCED_PARAMETER(pAllocator); // 创建新的模块实例 CHelloWorld* pModule = new CHelloWorld; // 判断是否分配成功 if (!pModule) { // 如果失败则返回内存不足错误 return HRESULT_FROM_WIN32(ERROR_NOT_ENOUGH_MEMORY); } else { // 成功创建后赋值输出参数 *ppModule = pModule; // 将局部指针置空 pModule = NULL; // 返回成功状态 return S_OK; } } // 销毁模块工厂的方法 void Terminate() { // 删除当前对象释放资源 delete this; } }; // 定义全局模块类，用于处理全局事件 class MyGlobalModule : public CGlobalModule { public: // 应用启动时触发的回调函数 GLOBAL_NOTIFICATION_STATUS OnGlobalApplicationStart( _In_ IHttpApplicationStartProvider* pProvider ) { // 忽略未使用的参数 UNREFERENCED_PARAMETER(pProvider); // 当前示例不启用调试输出 // OutputDebugStringA(LPCSTR("Hello World! : OnGlobalApplicationStart")); // 继续执行其他全局通知 return GL_NOTIFICATION_CONTINUE; } // 应用停止时触发的回调函数 GLOBAL_NOTIFICATION_STATUS OnGlobalApplicationStop( _In_ IHttpApplicationStopProvider* pProvider ) { // 忽略未使用的参数 UNREFERENCED_PARAMETER(pProvider); // 当前示例不启用调试输出 // OutputDebugStringA(LPCSTR("Hello World! : OnGlobalApplicationStop")); // 继续执行其他全局通知 return GL_NOTIFICATION_CONTINUE; } // PreBeginRequest 阶段触发的回调函数 GLOBAL_NOTIFICATION_STATUS OnGlobalPreBeginRequest( IN IPreBeginRequestProvider* pProvider ) { // 忽略未使用的参数 UNREFERENCED_PARAMETER(pProvider); // 当前示例不启用调试输出 // OutputDebugStringA(LPCSTR("Hello World! : OnGlobalPreBeginRequest")); // 继续执行其他全局通知 return GL_NOTIFICATION_CONTINUE; } // 析构方法，用于释放资源 VOID Terminate() { // 删除当前对象释放资源 delete this; } // 构造函数，初始化 Event Viewer 句柄 MyGlobalModule() { // 注册事件源到系统日志服务 m_hEventLog = RegisterEventSource(NULL, LPCSTR("IISADMIN")); } // 析构函数，释放 Event Viewer 资源 ~MyGlobalModule() { // 判断句柄是否有效 if (NULL != m_hEventLog) { // 释放句柄并置空 DeregisterEventSource(m_hEventLog); m_hEventLog = NULL; } } private: // 事件日志句柄 HANDLE m_hEventLog; // 写入事件日志的方法 BOOL WriteEventViewerLog(LPCSTR szNotification) { // 判断句柄是否有效 if (NULL != m_hEventLog) { // 报告事件信息到 Event Viewer return ReportEvent( m_hEventLog, EVENTLOG_INFORMATION_TYPE, 0, 0, NULL, 1, 0, &szNotification, NULL ); } // 返回失败状态 return FALSE; } }; // 模块注册入口函数，由 IIS 调用加载模块 HRESULT __stdcall RegisterModule( DWORD dwServerVersion, IHttpModuleRegistrationInfo* pModuleInfo, IHttpServer* pGlobalInfo ) { // 忽略未使用的参数 UNREFERENCED_PARAMETER(dwServerVersion); UNREFERENCED_PARAMETER(pGlobalInfo); // 当前示例不启用调试输出 // OutputDebugStringA(LPCSTR("Hello World! : RegisterModule")); // 创建全局模块实例 MyGlobalModule* pGlobalModule = new MyGlobalModule; // 判断是否创建成功 if (NULL == pGlobalModule) { // 失败则返回内存不足错误 return HRESULT_FROM_WIN32(ERROR_NOT_ENOUGH_MEMORY); } // 注册全局通知，监听 PreBeginRequest 事件 pModuleInfo->SetGlobalNotifications(pGlobalModule, GL_PRE_BEGIN_REQUEST); // 注册请求通知，监听 BeginRequest 事件 return pModuleInfo->SetRequestNotifications( new CHelloWorldFactory, RQ_BEGIN_REQUEST, 0 ); } 像我提供的例子是异步还是同步
最新发布
07-13
virtual void OnAsyncCompletion(HRESULT hr, DWORD bytes, BOOL fCompletion) override { // 处理完成后的回调 // 发送响应 m_pHttpContext->GetResponse()->WriteEntityChunks(...); // 通知IIS请求处理完成...
Exception from HRESULT:
weixin_30511107的博客
05-26 638
在MFC工程中，在类向导的时候，偶尔会遇到 “Exception from HRESULT:” 的问题，问题的原因可能是移动工程之类的操作破坏了工程的某些文件或者更改了某些路径的映射关系，这里有一个解决方法： 删除所有解决方案生成时产生的中间文件然后重新生成解决方案。 转载于:https://www.cnblogs.com/ethan-...
有趣的HRESULT
tempsitegoogle
02-19 519
有趣的HRESULT Author: ume Date: 2012-02-19 Outline:“Here’s Result” HRESULTstructure FAILED/SUCCEEDED MAKE_HRESULT FormatMessage 长时间进行Windows编程的人一定对HRESULT特别熟悉，因为HRESULT作为一种函数的返回值类型曝...
操作系统平台的编译问题HRESULT:Ox8007000B
e_zhiwen的专栏
09-18 4202
VS2008在win7 64bit下编译了一个sqlce35数据库操作程序，不知神马原因，在32bit上执行时出错了，报错代码为：HRESULT:Ox8007000B。 经过在VS2008上搞了N久没有搞定问题，再认真多看下有个什么版本问题。 想想只能在32bit的机器上再编译一次，这次32bit上搞定了，嗯又了解了一个代码问题。
HRESULT的详细说明
weixin_34419321的博客
12-10 437
2019独角兽企业重金招聘Python工程师标准>>> ...
win7 安装.Net framework 4.0出现 安装不成功，错误代码0x80240037 的解决方法
热门推荐
小白裸奔
08-11 43万+
1.安装说明 系统：win7 64位 安装包：dotNetFx40_Full_x86_x64.exe（.Net framework 4.0） 出现的问题：在win7 上安装dotNetFx40_Full_x86_x64.exe之后，弹出说明框：.Net framework 4安装未成功，原因是hresult 0x80240037 后面也采用了各种方法，还发现这种错误：你的电脑使用此 Win
printf("%x") 输出 0xFFFFFFFF81
qq_35003588的博客
02-27 1812
#include <stdio.h> int main() { char a = 0x81; printf("0x%x\n",a); // 0x81 在内存中存储为 1000 0001 这是个补码 ，变量a为有符号数 所以反码为 1000 0000 则源码为 1111 1111 这个数为 -127 // -127 在32位...
"对COM 组件的调用返回了错误 HRESULT E_FAIL"的解决方法
Jun's个人专栏
03-27 12万+
  有时调用com组件时，会返回“HRESULT E_FAIL”错误，这时有可能的错误原因除了代码有错外，另一个原因还可能是我们没有正常配置dcom的属性。如果是后者，我们可以按如下的方法来解决错误：  1）确保“Distributed Transaction Coordinator”服务是开启的。  2） 在运行中录入“dcomcnfg",打开组件服务字符串，选择组件服务--->计算机-
HRESULT的使用
weixin_46100993的博客
10-16 663
HRESULT hr = func(); if( SUCCEEDED( hr ) ){...} // 如果成功 if( FAILED( hr ) ) {...} // 如果失败 这篇文章总结较为详细<----- 可以紧跟着assert一同使用： // func()函数执行失败时该程序停止运行 HRESULT hres = func(); ASSERT(SUCCEEDED(hers)); ...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值