首页 > 代码库 > 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)局部接口指针变量。

在局部函数块中,一个局部接口指针变量被赋了值并调用了接口成员函数,则对该局部接口指针变量不必调用AddRef和Release函数。
(3)全局接口指针变量。
在把全局接口指针变量作为输入参数传给某个函数之前,调用AddRef,在函数返回之后调用Release。
(4)C++中类成员变量为接口指针变量:适用于(3)。
(5)在顺序执行过程中,如果对一个接口指针变量赋值,则对赋值后的接口指针变量调用AddRef,如果赋值前的接口指针变量还没有结束,则赋值前必须对它调用Release以便先结束它的使用。

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组件接口