COM 组件设计与应用7 - 编译、注册、调用
一、前言
上两回中,咱们用 ATL 写了第一个 COM 组件程序,这回中,主要介绍编译、注册和调用方法。示例程序你已经下载了吗?如果还没有下载,vc6.0 的用户点这里,vc.net 的用户点这里。
二、关于编译
2-1 最小依赖
“最小依赖”,表示编译器会把 ATL 中必须使用的一些函数静态连接到目标程序中。这样目标文件尺寸会稍大,但独立性更强,安装方便;反之系统执行的时候需要有 ATL.DLL 文件的支持。如何选择设置为“最小依赖”呢?答案是:删除预定义宏“_ATL_DLL”,操作方法见图一、图二。
图一、在vc6.0中,设置方法
图二、在 vc.net 2003中,设置方法
2-2 CRT库
如果在 ATL 组件程序中调用了 CRT 的运行时刻库函数,比如开平方 sqrt() ,那么编译的时候可能会报错“error LNK2001: unresolved external symbol _main”。怎么办?删除预定义宏“_ATL_MIN_CRT”!操作方法也见图一、图二。(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 程序编译的过程:
图三、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)。
三、关于注册
情况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 上是个“榜眼”呢......
四、关于组件调用
总的来说,调用组件程序大概有如下方法:
#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<>,这两个类都在 <atlbase.h> 中声明。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,多看示例程序吧。 写累了:-(
五、小结
敬请关注《COM 组件设计与应用(八)》------如何增加 ATL 组件中的第二个接口
Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=637271
- 将.net组件注册为com组件 2004-11-09 y97523szb
- [原创] 组件的自动注册与卸载 2005-05-31 yes555
- COM技术内幕中聚合的实现 2006-06-29 Meuck
- COM技术纵横谈 2001-04-30 ShowMan
- 程序员的常见误区之我见 2004-11-01 fswan
COM 组件设计与应用7 - 编译、注册、调用相关推荐
- COM 组件设计与应用(六)——用 ATL 写第一个组件(vc.net)
一.前言 1.与 <COM 组件设计与应用(五)>的内容基本一致.但本回讲解的是在 vc.net 2003 下的使用方法,即使你不再使用vc6.0,也请和上一回的内容,参照比对. 2.这第 ...
- COM 组件设计与应用(十一)—— IDispatch 及双接口的调用
原文:http://www.vckbase.com/index.php/wv/1236 一.前言 前段时间,由于工作比较忙,没有能及时地写作.其间收到了很多网友的来信询问和鼓励,在此一并表示感谢.咳. ...
- COM 组件设计与应用(六)
一.前言 1.与 <COM 组件设计与应用(五)>的内容基本一致.但本回讲解的是在 vc.net 2003 下的使用方法,即使你不再使用vc6.0,也请和上一回的内容,参照比对. 2.这第 ...
- COM 组件设计与应用(七)
COM 组件设计与应用(七) 编译.注册.调用 作者:杨老师 一.前言 上两回中,咱们用 ATL 写了第一个 COM 组件程序,这回中,主要介绍编译.注册和调用方法.示例程序你已经下载了吗?如果还没有 ...
- COM 组件设计与应用(十一)
COM 组件设计与应用(十一) IDispatch 及双接口的调用 作者:杨老师 下载源代码 一.前言 前段时间,由于工作比较忙,没有能及时地写作.其间收到了很多网友的来信询问和鼓励,在此一并 ...
- 【转载】COM 组件设计与应用(二)——GUID 和 接口
原文:http://vckbase.com/index.php/wv/1203.html COM 组件设计与应用 系列文章:http://vckbase.com/index.php/piwz?& ...
- COM组件设计与应用(三)(转载)
COM组件设计与应用(三) 数据类型 作者:杨老师 一.前言 上回书介绍了GUID.CLSID.IID和接口的概念.本回的重点是介绍 COM 中的数据类型.咋还不介绍组件程序的设计步骤呀?咳..... ...
- COM 组件设计与应用
目录 COM 组件设计与应用(一) 起源及复合文件... 1 COM组件设计与应用(二) GUID 和 接口... 10 COM组件设计与应用(三) 数据类型... 20 COM组件设计与应用(四) ...
- ueditor上传组件显示乱码_最全面的移动端 UI组件设计详解:中篇
上一期给大家讲解了<最全面的移动端UI组件设计详解:上篇>,主要分享了:布局组件和导航组件2个部分:这次给大家带来:基础组件.表单组件和反馈组件详解,希望你在设计APP.小程序.H5页面中 ...
- react组件设计原则_React组件设计规则
react的目的是将前端页面组件化,用状态机的思维模式去控制组件.组件和组件之间肯定是有关系得,通过合理得组件设计,给每一个组件划定合适得边界,可以有效降低当我们对页面进行重构时对其他组件之间得影响. ...
最新文章
- 王建春计算机应用基础,计算机应用基础(本)教学指南.pdf
- [jillzhang]ExtJs与WCF交互:生成树 --数据库版补充
- django不修改数据库创外键_python小项目使用django的数据库模型
- java 日期处理 口诀_java时间处理常用方法工具类
- Linux 命令之 declare -- 声明或显示 shell 变量
- Spring MVC学习总结(19)——SpringMVC权限注解拦截
- 实战Scribe日志搜集和数据分析
- whereis 命令(转)
- python char 相等_用 Python 实现 Excel文本函数
- 冒泡排序(普通,加强对比)
- kindeditor不过滤标签属性
- hdu-1068POJ1466 Girls and Boys---最大独立集
- 计算机在数据处理方面的论文,数据挖掘论文3000字范文参考(2)
- linux中的通配符指的是?
- oracle12c创建监听,Oracle 12c为PDB创建专用监听
- 获取字符串被分割后的总数组长度 java 类似UBound()方法
- 联想Y7000的屏幕亮度不能调节
- Snipaste的使用方法
- 【云真机平台】稳定性测试自动化脚本
- Kotlin骚气写法 三
热门文章
- Dijkstra + 堆优化
- AR/VR learning (2)--unity3D在android 上的手势识别与检测
- 【HDU 5965】扫雷【线性递推】
- idea ssm html增删改,intellij idea采用ssm框架实现的数据库增删查改demo
- 跨过Nginx上基于uWSGI部署Django项目的坑
- Linux下安装、配置、启动Apache
- 一起写一个Android图片轮播控件
- mybatis-plus 自定义QueryWrapper(一)实现查询函数
- 中星9号新增测试频道_直播卫星新增中央卫视18套高清电视节目频道测试
- Oracle递归sql