【转载】COM 组件设计与应用（七）——编译、注册、调用

原文：http://vckbase.com/index.php/wv/1218.html

 

1、前言

上两回中，我们用 ATL 写了第一个 COM 组件程序，这回中，主要介绍编译、册和调用方法。示例程序你已经下载了吗？若是尚未下载，vc6.0 的用户点，vc.net 的用户点这里。

2、关于编译

2-1 最小依赖

“最小依赖”，表示编译器会把 ATL 中必须使用的一些函数静态链接到目标程序中。这样目标文件尺寸会稍大，但独立性更强，安装方便；反之系统执行的时候须要有 ATL.DLL 文件的支持。如何选择设置为“最小依赖”呢？答案是：删除预约义宏“_ATL_DLL”，操做方法见图1、图二。

图1、在vc6.0中，设置方法

图2、在 vc.net 2003中，设置方法

2-2 CRT库

若是在 ATL 组件程序中调用了 CRT 的运行时刻库函数，好比开平方 sqrt() ，那么编译的时候可能会报错“error LNK2001: unresolved external symbol _main”。怎么办？删除预约义宏“_ATL_MIN_CRT”！操做方法也见图1、图二。（vc.net 2003 中的这个项目属性叫“在 ATL 中最小使用 CRT”）

2-3 MBCS/UNICODE

这个很少说了，在预约义宏中，分别使用 _MBCS 或 _UNICODE。

2-4 IDL 的编译

COM 在设计初期，就定了一个目标：要能实现跨语言的调用。既然是跨语言的，那么组件的接口描述就必须在任何语言环境中都要可以认识。怎么办？用 .h 文件描述？------ C语言程序员笑了，真方便！BASIC 程序员哭了:-( 所以，微软使用了一个新的文件格式---IDL文件（接口定义描述语言）。IDL 是一个文本文件，它的语言语法比较简单，很象C。具体 IDL 文件的讲解，见下一回《COM 组件设计与应用（八）之添加新接口》。IDL 通过编译，生成二进制的等价类型库文件 TLB 提供给其它语言来使用。图三示意了 ATL COM 程序编译的过程：

图3、ATL 组件程序编译过程

说明1：编译后，类型库以 TLB 文件形式单独存在，同时也保存在目标文件的资源中。所以，咱们未来在 #import 引入类型库的时候，既能够指定 TLB 文件，也能够指定目标文件；

说明2：咱们做为 C/C++ 的程序员，还算是比较幸福的。由于 IDL 编译后，特地为咱们提供了 C 语言形式的接口文件。

说明3：IDL 编译后生成代理/存根源程序，有：dlldata.c、xxx_p.c、xxxps.def、xxxps.mak，咱们能够用 NMAKE.EXE 再次编译来产生真正的代理/存根DLL目标文件(注1)。

3、关于注册

状况1：当咱们使用 ATL 编写组件程序，注册不用咱们来负责。编译成功后，IDE 会帮咱们自动注册；

状况2：当咱们使用 MFC 编写组件程序，因为编译器不知道你写的是不是 COM 组件，因此它不会帮咱们自动注册。这个时候，咱们能够执行菜单“Tools\Register Control”来注册。

状况3：当咱们写一个具备 COM 功能的 EXE 程序时，注册的方法就是运行一次这个程序；

状况4：当咱们须要使用第三方提供的组件程序时，能够命令行运行“regsvr32.exe 文件名”来注册。顺便说一句，反注册的方法是“regsvr32.exe /u 文件名”；

状况5：当咱们须要在程序中（好比安装程序）须要执行注册，那么：

typedef HRESULT (WINAPI * FREG)();
TCHAR szWorkPath[ MAX_PATH ];

::GetCurrentDirectory( sizeof(szWorkPath), szWorkPath );	// 保存当前进程的工做目录
::SetCurrentDirectory( 组件目录 );	// 切换到组件的目录

HMODULE hDLL = ::LoadLibrary( 组件文件名 );	// 动态装载组件
if(hDLL)
{
	FREG lpfunc = (FREG)::GetProcAddress( hDLL, _T("DllRegisterServer") );	// 取得注册函数指针
	// 若是是反注册，能够取得"DllUnregisterServer"函数指针
	if ( lpfunc )	lpfunc();	// 执行注册。这里为了简单，没有判断返回值
	::FreeLibrary(hDLL);
}

::SetCurrentDirectory(szWorkPath);	// 切换回原先的进程工做目录

　　

上面的示例，在多数状况下能够简化掉切换工做目录的代码部分。可是，若是这个组件在装载的时候，它须要同时加载一些必须依赖的DLL时，有可能因为它自身程序的 BUG 致使没法正肯定位。咳......仍是让咱们本身写的程序，来弥补它的错误吧......谁让我们是好人呢 ，谁让我们的水平比他高呢，谁让我们在 vckbase 上是个“榜眼”呢......

4、关于组件调用

总的来讲，调用组件程序大概有以下方法：

#include 方法	IDL编译后，为方便C/C++程序员的使用，会产生xxx.h和xxx_i.c文件。咱们真幸福，直接#include后就可使用了
#import 方法	比较通用的方法，vc 会帮咱们产生包装类，让咱们的调用更方便
加载类型库包装类 方法	若是组件提供了 IDispatch 接口，用这个方法调用组件是最简单的啦。不过还没讲IDispatch，只能看之后的文章啦
加载ActiveX包装类 方法	ActiveX 还没介绍呢，之后再说啦

下载示例程序后，请逐项浏览使用方法：

示例	方法	简要说明
1	#include	彻底用最基本的 API 方式调用组件，使你们熟悉调用原理
2	#include	大部分使用 API 方式，使用 CComBSTR 简化对字符串的使用
3	#include	展现智能指针 CComPtr<> 的使用方法
4	#include	展现智能指针 CComPtr<> 和 CComQIPtr<> 混合的使用方法
5	#include	展现智能指针 CComQIPtr<> 的使用方法
6	#include	展现智能指针的释放方法
7	#import	vc 包装的智能指针 IxxxPtr、_bstr_t、_variant_t 的使用方法和异常处理
8	#import	import 后的命名空间的使用方法

示例程序中都写有注释，请读者仔细阅读并同时参考 MSDN 的函数说明。这里，我给你们介绍一下“智能指针”：

对于操做原始的接口指针是比较麻烦的，须要咱们本身控制引用记数、API 调用、异常处理。因而 ATL 提供了2个智能指针的模板包装类，CComPtr<> 和 CComQIPtr<>，这两个类都在 中声明。CComQIPtr<> 包含了 CComPtr<>的全部功能，所以咱们能够彻底用 CComQIPtr<> 来使用智能接口指针，惟一要说明的一点就是：CComQIPtr<> 因为使用了运算符的重载功能，它会自动帮咱们调用QueryInterface()函数，所以 CComQIPtr<> 惟一的缺点就是不能定义 IUnknown * 指针。

// 智能指针 smart pointer，按照匈牙利命名法，通常以 sp 开头来表示变量类型
CComPtr < IUnknown > spUnk;	// 正确
// 假设 IFun 是一个接口类型
CComPtr < IFun > spFun;	// 正确
CComQIPtr < IFun > spFun;	// 正确
CComQIPtr < IFun, &IID_IFun > spFun;	// 正确
CComQIPtr < IUnknown > spUnk;	// 错误！CComQIPtr不能定义IUnknown指针

　　

给智能指针赋值的方法：

CComQIPtr < IFun > spFun;	// 调用构造函数，尚未赋值，被包装的内部接口指针为 NULL

CComQIPtr < IFun > spFun( pOtherInterface );	// 调用构造函数，内部接口指针赋值为
// 经过 pOtherInterface 这个普通接口指针调用QueryInterface()获得的IFun接口指针

CComQIPtr < IFun > spFun( spOtherInterface ); // 调用构造函数，内部接口指针赋值为
// 经过 spOtherInterface 这个只能接口指针调用QueryInterface()获得的IFun接口指针

CComQIPtr < IFun > spFun ( pUnknown );	// 调用构造函数，由IUnknown的QueryInterface()获得IFun接口指针

CComQIPtr < IFun > spFun = pOtherInterface;	// = 运算符重载，含义和上面同样
spFun = spOtherInterface;	// 同上
spFun = pUnknown;	// 同上

pUnknown->QueryInterface( IID_IFun, &sp );	// 也能够经过QueryInterface赋值

// 智能指针赋值后，能够用条件语句判断是否合法有效
if ( spFun ){}		// 若是指针有效
if ( NULL != spFun ){}	// 若是指针有效

if ( !spFun ){}		// 若是指针无效
if ( NULL == spFun ){}	// 若是指针无效

　　

智能指针调用函数的方法：

spFun.CoCreateInstance(...);	// 等价与 API 函数::CoCreateInstance(...)
spFun.QueryInterface(...);	// 等价与 API 函数::QueryInterface()

spFun->Add(...);	// 调用内部接口指针的接口函数

// 调用内部接口指针的QueryInterface()函数，其实效果和 spFun.QueryInterface(...) 同样
spFun->QueryInterface(...);	

spFun.Release();	// 释放内部的接口指针，同时内部指针赋值为 NULL
spFun->Release();	// 错！！！必定不要这么使用。
// 由于这个调用并不把内部指针清空，那么析构的时候会被再次释放（释放了两次）

　　

咳......不说了，不说了，你们多看书，多看MSND，多看示例程序吧。 写累了:-(

5、小结

敬请关注《COM 组件设计与应用(八)》------如何增长 ATL 组件中的第二个接口

注1：编译代理/存根，vc6.0 中稍微麻烦，咱们在后面介绍“进程外组件”和“远程组件”的时候再介绍。在 vc.net 2003 下则比较简单，由于代理/存根做为单独的一个工程项目会自动加到咱们的解决方案中了。