ATL介绍(四)

lithe

墨衍会员 · AI 创作全网分发码龄25年

关注

原创最新推荐文章于 2025-08-20 10:48:19 发布 1.8k 阅读 AI 写同款· GEO 优化 ›

ATL 介绍( 四 )

吕思伟--潘爱民

（接上期）

---- 4. 编译连接应用、注册COM 服务程序

---- 对ATL 工程的编译连接过程包括下面的几个步骤：

使用MIDL 编译工程的IDL 文件，形成接口定义的头文件和用于调度(Marshalling) 的代码。
编译工程的.cpp 文件形成目标文件。
连接目标文件，形成应用模块。
注册COM 服务程序。

---- 关于工程编译连接的其他部分同Visual C++ 中MFC 工程的编译连接过程相似，这里只重点介绍一下COM 服务程序的注册过程。

---- 在ATL 中，COM 服务程序的注册是在工程编译连接的最后阶段，由ATL 辅助完成的。在手工的COM 编程中，服务程序的注册是比较麻烦的工作。在ATL 中，系统通过读取在建立工程过程中形成的注册脚本文件来完成注册工作。注册脚本(Register Script，简称RGS) 是ATL 提供的文本方式的注册辅助文件。下面是注册脚本文件的一个实例。

---- HKCR －表示注册表中COM 对象的注册项，是HKEY_CLASS_ROOT 的缩写

{
	AuthTest.ActiveXObject.1 = s'ActiveXObject Class'
{
	CLSID = s '{97A5CB10-AF82-11D2-B9BC-00104B04B867}'
} － 对 象 的ProgID
AuthTest.ActiveXObject = s 'ActiveXObject Class'
{
	CLSID = s '{97A5CB10-AF82-11D2-B9BC-00104B04B867}'
} － 对 象 的 与 版 本 无 关 的ProgID
NoRemove CLSID  － 对 象CLSID 注 册 项
{
	ForceRemove {97A5CB10-AF82-11D2-B9BC-00104B04B867}
    = s 'ActiveXObject Class'
    {
	  ProgID = s 'AuthTest.ActiveXObject.1'
	      VersionIndependentProgID = s 'AuthTest.ActiveXObject'
	   InprocServer32 = s '%MODULE% ' 
       － 服 务 器 类 型， 表 示DLL 服 务 器
	       {
		val ThreadingModel = s 'both'
        － 线 程 模 型， 这 里 是BOTH 型
	       }
	}
	}
}

---- RGS 文件包含注册COM 服务程序的各项内容，通常我们不必修改此RGS 文件，必要时我们也可以手工修改RGS 文件来定制模块的注册过程。

四、应用ATL 的一个例子

---- 上面介绍了使用ATL 创建一个COM 服务程序的基本过程。在介绍过程中，我们实际上已经生成了一个COM 服务程序的基本框架，只是没有填写实际的内容。在下面部分，我们将具体开发一个十分简单的COM 服务程序，并且为它编写一段客户代码进行测试，使大家对使用ATL 开发COM 服务程序的过程有一个全面整体的了解。

---- 我们要开发的服务程序的功能很简单，它只实现一个接口，这个接口名字是ISimpleInterface，接口只有一个成员函数，叫做Welcome。这个函数的功能只是输出一个"Hello World!" 的字符串。

---- 按照上一部分介绍的创建COM 服务程序的步骤，我们进行如下的操作。

打开Visual C++ 集成开发环境。
创建一个称为SimpleTest 的ATL 工程。
在这个工程中插入新的对象，对象的名字是SimpleInterface。
设置接口ISimpleInterface 的有关属性，使它成为一个双接口。
在对象的接口ISimpleInterface 中加入方法Welcome。
打开ATL 加入的Welcome 方法的框架，可以看到如下的代码段。

STDMETHODIMP CActiveXObject::get_TestProp(long *pVal)
{
	  AFX_MANAGE_STATE(AfxGetStaticModuleState())

	  // TODO: Add your implementation code here

	  return S_OK;
}

---- 7 ．将程序框架中的注释部分替换为下面的代码：

     ::MessageBox(NULL,_T("Hello World!"),_T("Welcome"), MB_OK)。
Welcome 方 法 被 调 用 时 将 弹 出 一 个 消 息 框。

---- 8 ．编译连接工程。

---- 上面的步骤完成以后，我们就有了一个简单的COM 服务程序，而且已经被注册到当前系统中。

---- 下面我们要完成一个简单的COM 客户程序。一个COM 客户程序简单地说是使用COM 组件对象的程序。客户程序调用COM 对象的基本流程如下。

创建COM 对象的实例。这可以通过调用Windows 系统的API 函数CoCreateInstance 来完成。
通过接口调用函数。
调用IUnknown::Release 释放COM 对象实例。

---- 我们的客户程序是使用MFC 编写的一个基于对话框的简单应用程序。具体的过程如下：

打开Visual C++ 集成开发环境。
创建一个称为SimpleClient 的基于对话框的MFC 工程。
在对话框中加入一个按钮，名字为TEST。
在SimpleClient.cpp 文件中加入如下的代码。

---- (1) 在.cpp 文件 #include "simpleclientdlg.h" 之后加入下面的代码：

#include "d:/simpletest/simpletest_i.h"
// 根 据 需 要 修 改 头 文 件 的 路 径

---- 加入的头文件是在编译COM 服务程序过程中自动生成的，其中包含接口本身的定义、接口IID 的定义和COM 对象的CLSID 的定义。包含该头文件可以使客户程序能够使用COM 服务程序。

---- (2) 在按钮TEST 的消息控制函数中加入如下的代码：

 
HRESULT hr;   
ISimpleInterface* pIntf = NULL;
hr = CoCreateInstance
(CLSID_SimpleInterface, NULL, CLSCTX_SERVER , 
 IID_ISimpleInterface, (void **)& pIntf);
if(SUCCEEDED(hr))
{
pIntf- >Welcome();
pIntf- >Release();
}

---- 上面的代码首先通过系统API CoCreateInstance 创建COM 对象，得到接口的指针，然后调用接口成员函数Welcome，最后通过IUnknown::Release() 函数释放COM 对象实例。

---- 5 ．编译连接客户程序。

---- 最后，我们可以测试客户程序是否正常运行。启动客户程序，当单击"TEST" 按钮时我们可以看到弹出一个消息框，这正是我们的COM 服务程序提供的功能。（全文完）

---- （作者地址：北京大学计算机科学技术研究所，100871；收稿日期：1999.08）

收录于