COM组件三个最基本的接口类 //VC6中使用COM库的三种方法

COM组件有三个最基本的接口类，分别是IUnknown、IClassFactory、IDispatch。

　　COM规范规定任何组件、任何接口都必须从IUnknown继承，IUnknown包含三个函数，分别是 QueryInterface、AddRef、Release。这三个函数是无比重要的，而且它们的排列顺序也是不可改变的。QueryInterface用于查询组件实现的其它接口，说白了也就是看看这个组件的父类中还有哪些接口类，AddRef用于增加引用计数，Release用于减少引用计数。引用计数也是COM中的一个非常重要的概念。大体上简单的说来可以这么理解，COM组件是个DLL，当客户程序要用它时就要把它装到内存里。另一方面，一个组件也不是只给你一个人用的，可能会有很多个程序同时都要用到它。但实际上DLL只装载了一次，即内存中只有一个COM组件，那COM组件由谁来释放？由客户程序吗？不可能，因为如果你释放了组件，那别人怎么用，所以只能由COM组件自己来负责。所以出现了引用计数的概念，COM维持一个计数，记录当前有多少人在用它，每多一次调用计数就加一，少一个客户用它就减一，当最后一个客户释放它的时侯，COM知道已经没有人用它了，它的使用已经结束了，那它就把它自己给释放了。引用计数是COM编程里非常容易出错的一个地方，但所幸VC的各种各样的类库里已经基本上把AddRef的调用给隐含了，在我的印象里，我编程的时侯还从来没有调用过AddRef，我们只需在适当的时侯调用Release。至少有两个时侯要记住调用Release，第一个是调用了 QueryInterface以后，第二个是调用了任何得到一个接口的指针的函数以后，记住多查MSDN 以确定某个函数内部是否调用了AddRef，如果是的话那调用Release的责任就要归你了。 IUnknown的这三个函数的实现非常规范但也非常烦琐，容易出错，所幸的事我们可能永远也不需要自己来实现它们。

　　IClassFactory的作用是创建COM组件。我们已经知道COM组件实际上就是一个类，那我们平常是怎么实例化一个类对象的？是用‘new’命令!很简单吧，COM组件也一样如此。但是谁来new它呢？不可能是客户程序，因为客户程序不可能知道组件的类名字，如果客户知道组件的类名字那组件的可重用性就要打个大大的折扣了，事实上客户程序只不过知道一个代表着组件的128位的数字串而已，这个等会再介绍。所以客户无法自己创建组件，而且考虑一下，如果组件是在远程的机器上，你还能new出一个对象吗？所以创建组件的责任交给了一个单独的对象，这个对象就是类厂。每个组件都必须有一个与之相关的类厂，这个类厂知道怎么样创建组件，当客户请求一个组件对象的实例时，实际上这个请求交给了类厂，由类厂创建组件实例，然后把实例指针交给客户程序。这个过程在跨进程及远程创建组件时特别有用，因为这时就不是一个简单的new操作就可以的了，它必须要经过调度，而这些复杂的操作都交给类厂对象去做了。IClassFactory最重要的一个函数就是CreateInstance，顾名思议就是创建组件实例，一般情况下我们不会直接调用它，API函数都为我们封装好它了，只有某些特殊情况下才会由我们自己来调用它，这也是VC编写COM组件的好处，使我们有了更多的控制机会，而VB给我们这样的机会则是太少太少了。

　　IDispatch叫做调度接口。它的作用何在呢？这个世上除了C++还有很多别的语言，比如VB、 VJ、VBScript、JavaScript等等。可以这么说，如果这世上没有这么多乱七八糟的语言，那就不会有IDispatch。:-) 我们知道COM组件是C++类，是靠虚函数表来调用函数的，对于VC来说毫无问题，这本来就是针对C++而设计的，以前VB不行，现在VB也可以用指针了，也可以通过VTable来调用函数了，VJ也可以，但还是有些语言不行，那就是脚本语言，典型的如 VBScript、JavaScript。不行的原因在于它们并不支持指针，连指针都不能用还怎么用多态性啊，还怎么调这些虚函数啊。唉，没办法，也不能置这些脚本语言于不顾吧，现在网页上用的都是这些脚本语言，而分布式应用也是COM组件的一个主要市场，它不得不被这些脚本语言所调用，既然虚函数表的方式行不通，我们只能另寻他法了。时势造英雄，IDispatch应运而生。:-) 调度接口把每一个函数每一个属性都编上号，客户程序要调用这些函数属性的时侯就把这些编号传给IDispatch接口就行了，IDispatch再根据这些编号调用相应的函数，仅此而已。当然实际的过程远比这复杂，仅给一个编号就能让别人知道怎么调用一个函数那不是天方夜潭吗，你总得让别人知道你要调用的函数要带什么参数，参数类型什么以及返回什么东西吧，而要以一种统一的方式来处理这些问题是件很头疼的事。IDispatch接口的主要函数是Invoke，客户程序都调用它，然后Invoke再调用相应的函数，如果看一看MS的类库里实现 Invoke的代码就会惊叹它实现的复杂了，因为你必须考虑各种参数类型的情况，所幸我们不需要自己来做这件事，而且可能永远也没这样的机会。:-)

////////////////////////////////////////////////////////////////////////////////

本文所用的程序框架均为对话框模式的MFC EXE工程。在编程前，首先要确定待操作的代码组件是否已经在系统中注册。如果代码组件没有注册，可以通过Windows"System目录下的regsvr32. exe程序对其进行注册。

一、使用COM库函数

1．包含COM的头文件和接口定义的.c文件

在头文件中包含了接口的C++定义，在.c文件中说明了接口ID IID和类ID CLSID的符号化常量，例如写了一个COM库名称叫“SimpleTest”，则需要包含以下文件：

#include "simpletest.h"

#include "simpletest_i.c"

2．添加COM初始和终止代码。

在应用程序类的初始化实例函数InitInstance()中添加如下代码：

CoInitialize(NULL);

……

CoUnInitialize();

上述语句运行在MFC框架/非MFC框架中，但由于本文程序使用MFC框架，所以也可以利用AfxOleInit()函数对其进行初始化。

3. 创建组件对象。

HRESULT hr;  

ISimpleInterface* pIntf = NULL;

    hr = CoCreateInstance(CLSID_SimpleInterface, NULL, CLSCTX_SERVER ,

                          IID_ISimpleInterface, (void **)& pIntf);

    if(SUCCEEDED(hr))

    {

        pIntf->Welcome();

        pIntf->Release();

    }

二、使用类向导导入类型库

通过类向导可以直接阅读组件的类型库，并产生包装类型库中每个接口的类，通过这些类的成员函数可以访问组件接口的方法和属性，与使用ActiveX控件的方法有些类似。

1．添加对COM组件进行初始化的代码。

通过类向导的From a Type Library加入组件的.tlb类型库文件，并从中引入其接口类。在本例中引入的类型库文件中只包含一个从ColeDispatchDriver派生的组件包装类IAccount。通过包装类的成员，可以了解到组件接口能提供哪些服务，而且可以通过它们访问组件接口的方法和属性。

在初始化对话框函数里用COleDispatchDriver类的CreateDispatch()成员函数创建Account组件对象：

IAccount m_account;

……

m_account.CreateDispatch(“ATLSample.Account.1”));

其中ProgID值“ATLSample. Account. 1”可以通过Microsoft Visual Studio Tools 6.0里的OLE View工具查找到，其前提是该组件已被成功注册过。

释放Account组件对象也可以用COleDispatch-Driver类的ReleaseDispatch()函数来完成。

2．调用方法

对于在COM库函数方法中用过的Post方法可用下述方法调用：

CString str=m_account. Post(100);

可以看出此种方法实现了同样的功能但实现起来要比上一种方法简单些，而且对理解COM的要求也不高。

 

三、使用#import 指令

1．简要介绍

对于类型库文件采用该指令是非常合适的，因为不管是调试版本还是发行版本，对于类型库文件而言，其路径是固定的。＃import指令在执行时将会从待引入的类型库中提取出两个文件：一个.tlh文件和一个.tli文件，后者仅仅是包装类的函数实现，而前者则包含了许多有关的重要信息。智能接口指针也在其中定义：

_COM_SMARTPTR_TYPEDEF(IAccount,__uuidof(IAccount));

在实际编译时，编译器会将其展开成下述代码，并通过_com_ptr_t模板类为接口IAccount定义一个智能指针IAccountPtr。之所以说其是智能指针，是由于它替代IAccount时，会自动处理CoCreate-Instance和所有的IUnknow方法，使用起来非常方便：

typedef _com_ptr_t<_com_IIID< Iaccount,__uuidof(IAccount)>> IAccountPtr;

由于有了智能指针，我们就可以调用_com_ptr_t模板类的CreateInstance()函数来完成对接口指针的创建工作：

IAccountPtr m_account=NULL;

m_account.CreateInstance(__uuidof(Account));

由于在生成的.tlh文件中包含结构声明和declspec(uuid(“”))声明，所以在这里可以很方便地用__uuidof(Account)获取接口的GUID。declspec(uuid(“”))声明将GUID和类及每个接口联系起来，允许开发人员以uuidof操作符来获取类和接口的GUID。

需要特别指出的是: 为防止原有代码和新引入的代码之间发生名字冲突，编译器会定义一个由类型库名称标识的命名空间，并在其中声明的任何名称内附加一个标识符。而为了避免指定命名空间标识，可以在#import 语句后加上using namespace,而且还可以用rename_namespace来改变命名空间。比如在本例中可以进行如下处理：

#import “Account.tlb” rename_namespace(“AccountDriver”)

using namespace AccountDriver;

这样，在使用智能接口指针IAccountPtr时只需定义即可：

IAccountPtr m_account;

至于对代码组件中的函数和属性的调用则同前两种方法一样，也是通过m_account来完成访问的。由于_com_ptr_t模板类和智能指针的引入，#import 指令方法是这三种方法中使用COM组件最简单的一种。

2．使用方法

在stdafx.h文件的最后加上下面这句话：

#import "SimpleTest.tlb" no_namespace

ISimpleInterfacePtr* m_account= new ISimpleInterfacePtr;

m_account->CreateInstance(__uuidof(SimpleInterface));

m_account->Interface.Welcome();

对于第一大点的例子，可以这么调用：

CoInitialize(NULL);

ISimpleInterface simple;

simple.CreateDispatch("SimpleTest.SimpleInterface.1");

simple.Welcome();

simple.ReleaseDispatch();

CoUninitialize();