COM原理
COM 数据类型HRESULT
2022-02-16
65
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其实是一个双字节值,最高位为0表示成功,1表示错误。D16~D30为设备代码。
程序中如果需要判断返回值,可使用比较运算符号；switch开关语句；也可使用VC提供的宏：
HRESULT hr=调用组件函数;
if(SUCCEEDED(hr)){...} //如果成功
if(FAILED(hr)){...} //如果失败
