COM指南 (Step by Step COM Tutorial)-上

原作者：Saurabh Dasgupta

文章出处：http://www.codeguru.com/activex/COMStepByStep.html

 

 

译者的话，首先要声明的，这以一篇来自于WWW.CODEGURU.COM上的文章，我只是将其翻译。要告诉您的是，如果您已经是一个COM高手了，请您不要浪费时间来读它了，如果您想给我这个新手一点意见，我不胜感激。如果您是学习COM的入门者，我觉得，他还是很有帮助的，至少，你可以通过手动的添加代码而不是使用Visual C++的向导来完成，让你了解要实现一个简单的com对象，所需要完成的工作。因为本人曾写了一点很浅的文字，因为没有写下内容介绍，遭到了非议。所以在此写下这些文字，希望让别人很快的了解文章的内容，读于不读，有所选择。愿和所有初学者共勉。

 

目录：

介绍

接口

第一步：创建IDL文件

第二步：生成类型库

第三步：从IAdd继承

第四步：实现IAdd的方法

第五步：实现IUnkown

第六步：类工厂

第七步：实现IClassFactory的方法

第八步：实现DllGetClassObject

第九步：实现DllCanUnloadNow

第十步：DllRegisterServer和UnregisterServer

第十一步：将IDL文件插入到工作空间中

第十二步：在Visual Basic 中使用COM刚创建的对象

 第十三步：分析我们刚创建的所有文件

第十四步：在ActiveX DLL中嵌入类型库

第十五步：从Visual C++客户方使用刚创建的COM对象

 

介绍

对于我来说，理解COM(Component Object Model)至少是不止一次的冒险旅行了。我相信，每一个希望理解COM背后基本理论的程序员，一定有过使用没有MFC/ATL的模板和宏帮助下的C++语言写了至少一个以上的简单的COM对象。在这篇文章中，我会根据COM的基本原理，介绍创建一个简单COM对象的步骤。这个创建的组件可以在VC/VB的客户端使用。

作为练习，我们会试图设计一个COM对象，实现一个假想的超级快速的加法算法。这个组件有两个长整型（long type）的参数，其返回值也是一个长整型数，是我们加法算法的结果。下面我们就开始设计这个接口。

接口

COM对象的接口，我们不会谈到实际的实现，而是要谈论使用这个COM对象并与之通信的方法签名（method signatures）。我们将会命名我们的接口为IAdd。 这个接口的声明使用接口定义语言来完成（Interface Definition Language --IDL），接口定义语言是用来定义函数签名（Function Signatures）的，它使用一种独立于编程语言的格式，这有助于RPC组织从一个计算机到另一个的打包、分发和解包的参数。在我们的接口IAdd中，我们有两个方法SetFirstNumber和SetSecondNumber，这两个方法用来传递加法使用的参数。然后，还有另外一个方法DoTheAddition，他用来计算实际的结果并将结果返回给客户。

第一步：创建IDL文件

创建一个新的win32 DLL工程（命名为AddObj）。接下来的所有文件将被创建到此文件夹。创建一个空文件并键入下面的内容，把它保存为IAdd.idl。接口标识符使用uuidgen.exe生成（uuidgen.exe是一个dos文件，可以在命令行直接运行它）

import "unknwn.idl";

 

[

object,

uuid(1221db62-f3d8-11d4-825d-00104b 3646c 0),

helpstring("interface  IAdd is used for implementing a super-fast addition Algorithm")

]

 

interface IAdd : IUnknown

    {

    HRESULT     SetFirstNumber(long nX1);

 

    HRESULT     SetSecondNumber(long nX2);

   

    HRESULT     DoTheAddition([out,retval] long *pBuffer);

    };

 

[

uuid(3ff1aab8-f3d8-11d4-825d-00104b 3646c 0),

helpstring("Interfaces for Code Guru algorithm implementations .")

]

library CodeGuruMathLib

    {

    importlib("stdole32.tlb");

    importlib("stdole2.tlb");

 

    interface IAdd;

    }

第二步 生成类型库

使用IDL编译器MIDL.EXE编译接口定义文件IAdd.idl。编译完成后，将会生成以下的文件：

IAdd.h	包含C++格式的接口声明
dlldata.c	包含代理DLL的代码。当在一个不同的处理器/计算机上调用对象时使用
IAdd.tlb	二进制文件。使用一个定义好的格式完全的描述我们的IAdd接口和它所有的方法。这个文件和COM组件分发给所有的客户。
IAdd_p.c	包含代理DLL的列集代码。当在一个不同的处理器/计算机上调用对象时使用
IAdd_i.c	包含接口ID（IID）

（译者注：编译方法为，如过你的机器已经安装了Visual Studio环境的话，那么你可以直接从命令行写入如下的语句，midl.exe ../ AddObj/iadd.idl ）

第三步 从IAdd继承

我们将在此步骤中创建一个COM对象。创建一个新文件（AddObj.h），声明一个C++类，命名这个类为CAddObj，从接口IAdd继承（在文件IAdd.h）。记住，IAdd继承自IUnknown，IUnknown是一个抽象基类。因而我们不得不像IUnknown一样为抽象基类IAdd声明所有的方法。

 

///

//

//AddObj.h

//Contains the C++ class declarations for implementing the IAdd

//interfaces

//

#include    "IAdd.h"

extern long g_nComObjsInUse;

class CAddObj :

        public IAdd

    {

    public:

 

    //IUnknown interface

    HRESULT __stdcall QueryInterface(

                                REFIID riid ,

                                void **ppObj);

    ULONG   __stdcall AddRef();

    ULONG   __stdcall Release();

 

    //IAdd interface

    HRESULT __stdcall SetFirstNumber( long nX1);

    HRESULT __stdcall SetSecondNumber( long nX2);

    HRESULT __stdcall DoTheAddition( long *pBuffer);

 

    private:

 

    long m_nX1 , m_nX2; //operands for addition

    long m_nRefCount;   //for managing the reference count

    };

 

///

 

 

• COM指南 (Step by Step COM Tutorial)-中 
• COM指南 (Step by Step COM Tutorial)-下(1)      
• COM指南 (Step by Step COM Tutorial)-下(2)