原作者: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
};
///