COM原理
+ -

COM 数据类型HRESULT

2022-02-16 24 0

COM组件是运行在分布式环境中的。比如,写一个组件程序(DLL或EXE),使用者可能是在本机的某个进程内加载组件(INPROC_SERVER);也可能是从另一个进程中调用组件进程(LOCAL_SERVER);也可能是在这台计算机上调用地球那边计算机上的组件(REMOTE_SERVER)。所以,在理解和设计时,要时刻想起这句话。

程序的函数返回值,有好多种形式,如下

函数 返回值 信息
double sin(double) 浮点数值 计算正玄值
BOOL DeleteFile(LPCTSTR) 布尔值 文件删除是否成功。失败,需要GetLastError才能取得失败原因
void * malloc(size_t) 内存指针 内存申请,如果失败,返回空指针NULL
LONG RegDeleteKey 整数 删除注册表项。0表示成功,非0失败,这个值反映了失败原因
UINT DragQueryFile 整数 取得拖放文件信息。入参不同,返回值含义不同:文件个数,文件名长度,字符长度。

如此含义多变的返回值,使大家在学习和使用过程中,增加了额外困难。COM设计规范对它们进行了统一。
组件API及接口指针中,除IUnknown::AddRef和IUnknown::Release外,其它所有函数,都返回HRESULT。
假如一个组件的接口函数叫Add(),完成2个整数的加法运算,在C语言中,可如下定义:

long Add(long n1,long n2)
{
    return n1 + n2;
}

COM组件运行在分布式环境中。也就是说,这个函数可能运行在“地球另一边”的计算机上,既然运行在那么遥远的地方,就有可能出现服务器关机、网络掉线、运行超时、对方不在服务区……等异常。于是,这个加法函数,除需要返回运算结果外,还应该返回一个值:函数是否被正常执行了。

HRESULT Add(long n1,long n2,long *pSum)
{
    *pSum = n1 + n2;
    return S_OK;
}

如果函数正常执行,返回S_OK,函数运行结果则通过参数指针返回。
如果遇到了异常情况,则COM系统经过判断,会返回相应的错误值。常见的返回值有:

HRESULT 含义(成功都是S前缀,失败都是E前缀)
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结构

HRESULT其实是一个双字节值,最高位为0表示成功,1表示错误。D16~D30为设备代码。
程序中如果需要判断返回值,可使用比较运算符号;switch开关语句;也可使用VC提供的宏:

HRESULT hr=调用组件函数;
if(SUCCEEDED(hr)){...}                //如果成功
if(FAILED(hr)){...}                    //如果失败

0 篇笔记 写笔记

COM开发时使用的Win32 SDK头文件、宏定义和HRESULT
Win32 SDK提供的头文件Unknwn.h 标准接口IUnknown和IClassFacatory的IID及接口成员函数的定义Wtypes.h 包含COM使用的数据结构的说明Objidl.h ......
COM 数据类型HRESULT
COM组件是运行在分布式环境中的。比如,写一个组件程序(DLL或EXE),使用者可能是在本机的某个进程内加载组件(INPROC_SERVER);也可能是从另一个进程中调用组件进程(LOCAL_SERVER);也可能是在这台计算机上调用地球那边计算机上的组件(REMOTE_SERVER)。所以,在理解......
作者信息
我爱内核
Windows驱动开发,网站开发
好好学习,天天向上。
取消
感谢您的支持,我会继续努力的!
扫码支持
扫码打赏,你说多少就多少

打开支付宝扫一扫,即可进行扫码打赏哦

您的支持,是我们前进的动力!