首页 > 代码库 > com组件接口
com组件接口
int
main(
int
argc,
char
*argv[] )
{
cout <<
"Initializing COM"
<< endl;
if
( FAILED( CoInitialize( NULL )))
{
cout <<
"Unable to initialize COM"
<< endl;
return
-1;
}
ISampleMath* pSampleMath;
HRESULT
hr;
// This time use CoCreateInstance
hr = CoCreateInstance( CLSID_SampleMath,
NULL,
CLSCTX_LOCAL_SERVER,
IID_ISampleMath,
(
void
**) &pSampleMath );
if
( FAILED( hr ))
{
cout <<
"Failed to create server instance. HR = "
<< hr << endl;
CoUninitialize();
return
-1;
}
// Access the IMath interface
long
lResult;
pSampleMath->Add( 134, 353, &lResult );
cout <<
"134 + 353 = "
<< lResult << endl;
// Release all of our interfaces
if
( pSampleMath )
CoUninitialize();
return
0;
}
COM组件可以是一个Dll(进程内组件),也可以是一个EXE(进程外组件)。进程内组件就是组件和客户程序在同一进程内,进程外组件即组件和客户程序分别有自己的进程空间。
一个COM组件可以包含多个COM对象,一个COM对象又可以有多个接口。
第2章 COM对象和接口
2.1 CLSID和IID
对于COM对象来说,接口是它与外界进行交互的唯一途径。
每个COM对象,可以用CLSID来标识,COM对象的每个接口可以用IID来标识。CLSID和IID都是128位的标识符GUID,是一个随机数,可以由两方面特性来保证:空间(如网络适配器地址)和时间。
GUID可以通过COM库的API函数生成:
HRESULT CoCreateGuid( GUID * pguid );
2.1.2 COM对象和C++对象的不同
COM对象的数据成员封装以组建模块为最终边界,对于对象用户是完全透明的、不可见的,用户必须通过接口方法来访问数据成员;C++对象的封装特性只是语义上的,用户可以直接看到数据成员。
2.2 COM接口结构
接口是包含了一组函数的数据结构。客户程序利用这些函数获得组件对象的服务。接口成员函数中的字符串变量必须使用Unicode字符指针。
客户程序用一个指向接口数据结构的指针来调用接口成员函数,接口指针又指向pVtable(指向vtable的指针),pVtable指向一组函数,称为接口函数表(虚函数表vtable),表中每一项为4个字节长的函数指针,每个函数指针再指向函数的具体实现。
2.2.2 接口描述语言IDL
2.3 IUnknown接口
COM定义的每个接口都必须从IUnknown接口继承过来,因为IUnknown接口提供了两个重要特性:生存期控制和接口查询。
QueryInterface用于查询COM对象的其他接口指针,AddRef和Release用于对引用计数进行操作。
在COM对象级实现引用计数,精细度比较合适。
2.3.1 使用引用计数规则
(1)函数的参数中使用接口指针变量。
输入参数:在被调用函数中,不必调用AddRef和Release函数。
输出函数:在被调用函数返回之前,对输出参数调用AddRef,增加引用计数。
输入-输出参数:在参数被修改之前,对原来传进来的接口指针调用Release,引用计数减1,在参数被修改之后,对新的接口指针变量指针调用AddRef,若在函数执行过程中,参数没有被修改,则不必调用AddRef和Release函数。
(2)局部接口指针变量。
COM的实现
3.1 进程内组件(DLL)的实现,可以参考DLL技术,主要参数为:
1)LoadLibrary:装载DLL模块
2)GetProcAddress:取引出函数的地址
3)FreeLibrary:释放DLL模块
COM采用LPC(本地过程调用)和RPC(远程过程调用)的方法进行进程之间的通信,LPC用于在同一机器上的不同进程之间进行通信,而RPC用于在不同机器上的进程之间进行通信。
3.2 组件程序的两个用于注册的入口函数为DllRegisterServer和DllUnregisterServer,注册组件使用命令:RegSvr32 *.dll;反注册组件使用命令:RegSvr32 /u *.dll,进程内组件注册使用此命令。进程外组件注册必须支持两个命令行参数/RegServer 和/UnregServer。
3.3 类厂
COM库通过类厂创建COM对象,对应每一个COM类,都有一个类厂专门用于该COM类的对象创建工作。类厂本身也是一个COM对象,它支持接口IClassFactory。
CreateInstance创建对应的COM对象,LockServer控制组件的生存周期。
类厂由函数DllGetClassObject创建。
DllGetClassObject返回类厂对象的接口指针,再通过CreateInstance创建对应的COM对象。
3.3.2 COM库与类厂的交互
创建对象函数:
1)若创建远程对象或希望一次获取对象的多个接口指针,选用CoCreateInstanceEx。
2)若希望获取类厂对象或要调用类厂的某些成员函数,选用CoGetClassObject,通常IID=IID_IclassFactory,进程内组件直接调用DLL的CoGetClassObject,若CoGetClassObject创建的类厂对象位于进程外组件,函数启动组件进程,然后等待,直到组件进程把它支持的COM类对象的类厂注册到COM中,返回类厂信息。
3)其他情况下,选用CoCreateInstance创建对象,CoCreateInstance封装类厂创建对象的过程,返回COM对象的接口指针,不能创建远程机器上的对象。
3.4 COM库
COM库初始化函数:CoInitialize
COM库终止函数:CoUninitialize
3.4.2 COM库的内存管理
COM提供的内存管理器标准,是一个COM接口IMalloc。当组件内存的分配和释放不在同一模块,需要用到内存管理器,COM库封装了三个API函数,用于内存分配和释放
CoTaskMemAlloc
CoTaskMemFree
CoTaskMemRealloc
3.4.3 组件程序的装载和卸载
1)进程内组件的装载、卸载
2)进程外组件的装载、卸载
组件程序满足两个条件才可以被卸载:组件中对象数为0;类厂的锁计数器为0。此时,DllCanUnloadNow返回TRUE。
在判断返回类型HRESULT时,需用宏SUCCEEDED和FAILED。
com组件接口