查看完整版本: COM组件设计与应用7 编译,注册和调用

COM组件设计与应用7 编译,注册和调用

COM组件设计与应用7 编译,注册和调用知识若不分享 实在没有意义　http://www.d-programming-language-china.org　20070516点击下面网址查看原文:http://www.d-programming-language-china.orgby:        杨老师前言        上两回中，咱们用 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 程序编译的过程：( 本文出处: http://www.d-programming-language-china.org )        图三、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：当我们需要在程序中（比如安装程序）需要执行注册，那么：        QUOTE:                                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);    // 切换回原先的进程工作目录                D语言论坛 http://www.d-programming-language-china.org 按：        D语言风格的写法是这样：( 本文出处: http://www.d-programming-language-china.org )        [Copy to clipboard] [ - ]CODE:                                //HRESULT (*pfn_t)()是C风格写法。D这样：HRESULT function() pfn_t                //相当于alias ( HRESULT int function() )    pfn_t                extern (Windows) alias HRESULT (*pfn_t)();                                int dll_regserver(char *dllname, int flag)                {                    char *fn = flag ? cast(char*)"DllRegisterServer"                            : cast(char*)"DllUnregisterServer";                    int result = 1;                    pfn_t pfn;                    HINSTANCE    hMod;                                    if (SUCCEEDED(CoInitialize(null)))                    {                    hMod=LoadLibraryA(dllname);                    printf("hMod = %d\n", hMod);                    if (hMod > cast(HINSTANCE)HINSTANCE_ERROR)                    {                        printf("LoadLibraryA() succeeded\n");                        pfn = GetProcAddress(hMod, fn);                        printf("pfn = %p, fn = '%s'\n", pfn, fn);                        // http://www.d-programming-language-china.org 注：pfn是函数指针，*pfn是执行函数。这是指针常识。                        if (pfn && SUCCEEDED((*pfn)()))                        result = 0;                        CoFreeLibrary(hMod);                        CoUninitialize();                    }                    }                    return result;                }                上面程序来自D samples中的dclient.d。        上面的示例，在多数情况下可以简化掉切换工作目录的代码部分。但是，如果这个组件在装载的时候，它需要同时加载一些必须依赖的DLL时，有可能由于它自身程序的 BUG 导致无法正确定位。咳......还是让我们自己写的程序，来弥补它的错误吧......谁让咱们是好人呢 ，谁让咱们的水平比他高呢，谁让咱们在 vckbase 上是个“榜眼”呢......( 本文出处: http://www.d-programming-language-china.org )关于组件调用        总的来说，调用组件程序大概有如下方法：                        #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 * 指针。        QUOTE:                                // 智能指针 smart pointer，按照匈牙利命名法，一般以 sp 开头来表示变量类型                CComPtr ＜ IUnknown ＞ spUnk;    // 正确                // 假设 IFun 是一个接口类型                CComPtr ＜ IFun ＞ spFun;    // 正确                CComQIPtr ＜ IFun ＞ spFun;    // 正确                CComQIPtr ＜ IFun, &IID_IFun ＞ spFun;    // 正确                CComQIPtr ＜ IUnknown ＞ spUnk;    // 错误！CComQIPtr不能定义IUnknown指针                给智能指针赋值的方法：        QUOTE:                                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 ){}    // 如果指针无效                智能指针调用函数的方法：( 本文出处: http://www.d-programming-language-china.org )        QUOTE:                                spFun.CoCreateInstance(...);    // 等价与 API 函数::CoCreateInstance(...)                spFun.QueryInterface(...);    // 等价与 API 函数::QueryInterface()                spFun-＞Add(...);    // 调用内部接口指针的接口函数                // 调用内部接口指针的QueryInterface()函数，其实效果和 spFun.QueryInterface(...) 一样                spFun-＞QueryInterface(...);                spFun.Release();    // 释放内部的接口指针，同时内部指针赋值为 NULL                spFun-＞Release();    // 错！！！一定不要这么使用。                // 因为这个调用并不把内部指针清空，那么析构的时候会被再次释放（释放了两次）                咳......不说了，不说了，大家多看书，多看MSND，多看示例程序吧。 写累了:-(小结        敬请关注《COM 组件设计与应用(八)》------如何增加 ATL 组件中的第二个接口        --------------------------------------------------------------------------------        注1：编译代理/存根，vc6.0 中稍微麻烦，我们在后面介绍“进程外组件”和“远程组件”的时候再介绍。在 vc.net 2003 下则比较简单，因为代理/存根作为单独的一个工程项目会自动加到我们的解决方案中了。( lastupdate:20070517　最新文章请访问http://www.d-programming-language-china.org )关于一大步成功社区:yidabu提倡在交流中学习，在分享中提高收集感兴趣的知识，写下心得，通过网络与别人一起分享理解一点就实践一步，收获什么就分享什么，成功就是这样一点点一步步累积起来的网络只是一个工具，只有自己身心提高才是实实在在的。d-programming-language-china.org为大家提供一个学习交流各种知识的平台