HRESULT

HRESULT详解

最新推荐文章于 2025-12-04 10:52:38 发布

转载最新推荐文章于 2025-12-04 10:52:38 发布 · 640 阅读

文章标签：

#structure #function #interface #windows

vc++ 专栏收录该内容

30 篇文章

订阅专栏

本文详细介绍了HRESULT的概念及其在Windows系统中的应用。HRESULT是一种简单的数据类型，通常用于接口调用的返回值，由严重性代码、上下文信息、设施代码和状态代码组成。文章列举了常见的HRESULT值及其含义，并解释了如何通过SUCCEEDED和FAILED宏来判断函数调用是否成功。

（来源：http://baike.baidu.com/view/1754469.htm ）

　函数返回值。如果这个函数是执行完返回的话将包含具有实际意义的数据，如果立即返回则包含状态信息--发送成功与否，并不能说明执行的如何。
　　HRESULT
　　A value returned from a function call to an interface, consisting of a severity code, context information, a facility code, and a status code that describes the result. For 16-bit Windows systems, the HRESULT is an opaque result handle defined to be zero for a successful return from a function, and nonzero if error or status information is to be returned. To convert an HRESULT into a more detailed SCODE (or return value), applications call GetSCode(). See SCODE.
　　HRESULT 是一种简单的数据类型，通常被属性和 ATL 用作返回值。下表说明各种不同的值。头文件 winerror.h 中包含更多的值。
　　名称说明值
　　S_OK 操作成功 0x00000000
　　E_UNEXPECTED 意外的失败 0x8000FFFF
　　E_NOTIMPL 未实现 0x80004001
　　E_OUTOFMEMORY 未能分配所需的内存 0x8007000E
　　E_INVALIDARG 一个或多个参数无效 0x80070057
　　E_NOINTERFACE 不支持此接口 0x80004002
　　E_POINTER 无效指针 0x80004003
　　E_HANDLE 无效句柄 0x80070006
　　E_ABORT 操作已中止 0x80004004
　　E_FAIL 未指定的失败 0x80004005
　　E_ACCESSDENIED 一般的访问被拒绝错误 0x80070005
　　不能简单地把返回值与 S_OK 和 S_FALSE 比较，而要用 SUCCEEDED 和 FAILED 宏进行判断。
　　HRESULT 其实是一个双字节的值，其最高位(bit)如果是0表示成功，1表示错误。具体参见 MSDN 之"Structure of COM Error Codes"说明。我们在程序中如果需要判断返回值，则可以使用比较运算符号；switch开关语句；也可以使用VC提供的宏： HRESULT hr = 调用组件函数;
　　if( SUCCEEDED( hr ) ){...} // 如果成功
　　......
　　if( FAILED( hr ) ){...} // 如果失败