COM编程入门篇.pdf

《COM编程入门篇.pdf》由会员分享，可在线阅读，更多相关《COM编程入门篇.pdf（23页珍藏版）》请在得力文库 - 分享文档赚钱的网站上搜索。

1、COM 编程入门本文的目的是为刚刚接触 COM 的程序员提供编程指南，并帮助他们理解COM 的基本概念。内容包括 COM 规范简介，重要的 COM 术语以及如何重用现有的 COM 组件。本文不包括如何编写自己的 COM 对象和接口。COM 即组件对象模型，是 Component Object Model 取前三个字母的缩写，这三个字母在当今Windows的世界中随处可见。随时涌现出来的大把大把的新技术都以COM为基础。各种文档中也充斥着诸如 COM 对象、接口、服务器之类的术语。因此，对于一个程序员来说，不仅要掌握使用 COM 的方法，而且还要彻底熟悉 COM 的所有一切。本文由浅入深描述 C

2、OM 的内在运行机制，教你如何使用第三方提供的 COM 对象（以Windows 外壳组件 Shell 为例）。读完本文后，你就能掌握如何使用 Windows 操作系统中内建的组件和第三方提供的 COM 对象。本文假设你精通 C+语言。在例子代码中使用了一点 MFC 和 ATL，如果你不熟悉 MFC和 ATL 也没关系，本文会对这些代码进行完全透彻的解释。本文包括以下几个部分：C CO OM M到到底底是是什什么么？COM 标准的要点介绍，它被设计用来解决什么问题？基基本本元元素素的的定定义义COM 术语以及这些术语的含义。使使用用和和处处理理 C CO OM M 对对象象如何创建、使用和销毁

3、COM 对象。基基本本接接口口描述 IUnknown 基本接口及其方法。掌掌握握串串的的处处理理在 COM 代码中如何处理串。应应用用 C CO OM M 技技术术例例子子代代码码，举例说明本文所讨论的所有概念。处处理理 H HR RE ES SU UL LT THRESULT 类型描述，如何监测错误及成功代码。C CO OM M到到底底是是什什么么？简单地说，COM 是一种跨应用和语言共享二进制代码的方法。与 C+不同，它提倡源代码重用。ATL 便是一个很好的例证。源码级重用虽然好，但只能用于 C+。它还带来了名字冲突的可能性，更不用说不断拷贝重用代码而导致工程膨胀和臃肿。Windows 使

4、用 DLLs 在二进制级共享代码。这也是 Windows 程序运行的关键重用kernel32.dll,user32.dll 等。但 DLLs 是针对 C 接口而写的，它们只能被 C 或理解 C 调用规范的语言使用。由编程语言来负责实现共享代码，而不是由 DLLs 本身。这样的话 DLLs 的使用受到限制。MFC引入了另外一种MFC扩展DLLs二进制共享机制。但它的使用仍受限制只能在 MFC程序中使用。COM通过定义二进制标准解决了这些问题，即COM明确指出二进制模块（DLLs和EXEs）必须被编译成与指定的结构匹配。这个标准也确切规定了在内存中如何组织COM对象。COM定义的二进制标准还必须独

5、立于任何编程语言（如 C+中的命名修饰）。一旦满足了这些条件，就可以轻松地从任何编程语言中存取这些模块。由编译器负责所产生的二进制代码与标准兼容。这样使后来的人就能更容易地使用这些二进制代码。在内存中，COM 对象的这种标准形式在 C+虚函数中偶尔用到，所以这就是为什么许多COM 代码使用 C+的原因。但是记住，编写模块所用的语言是无关的，因为结果二进制代码为所有语言可用。此外，COM 不是 Win32 特有的。从理论上讲，它可以被移植到 Unix 或其它操作系统。但是我好像还从来没有在 Windows 以外的地方听说过 COM。基基本本元元素素的的定定义义我们从下往上看。接口只不过是一组函数

6、。这些函数被称为方法。接口名字以大写的 I开头，例如 C+中的 IShellLink，接口被设计成一个抽象基类，其中只有纯粹的虚拟函数。接口可以从其它接口继承，这里所说的继承的原理就好像 C+中的单继承。接口是不允许多继承的。coclass（简称组件对象类component object class）被包含在 DLL 或 EXE 中，并且包含着一个或者多个接口的代码。组件对象类（coclasss）实现这些接口。COM 对象在内存中表现为组件对象类（coclasss）的一个实例。注意 COM“类”和 C+“类”是不相同的，尽管常常 COM 类实现的就是一个 C+类。COM 服务器是包含了一个或多

7、个 coclass 的二进制（DLL 或 EXE）。注册（Registration）是创建注册表入口的一个过程，告诉 Windows 操作系统 COM 服务器放在什么位置。取消注册（Unregistration）则相反从注册表删除这些注册入口。GUID（谐音为“fluid”，意思是全球唯一标示符globally unique identifier）是个 128位的数字。它是一种独立于COM编程语言的标示方法。每一个接口和coclass有一个GUID。因为每一个 GUID 都是全球唯一的，所以避免了名字冲突（只要你用 COM API 创建它们）。有时你还会碰到另一个术语 UUID（意思也是全球唯

8、一标示符universally uniqueidentifier）。UUIDs 和 GUIDs 在实际使用时的用途是一样的。类 ID 或者 CLSID 是命名 coclass 的 GUID。接口 ID 或者 IID 是命名接口的 GUID。在 COM 中广泛地使用 GUID 有两个理由：1、GUIDs 只是简单的数字，任何编程语言都可以对之进行处理。2、GUIDs 可以在任何机器上被任何人创建，一旦完成创建，它就是唯一的。因此，COM 开发人员可以创建自己特有的 GUIDs 而不会与其它开发人员所创建的 GUIDs 有冲突。这样就消除了集中授权发布 GUIDs 的必要。HRESULT 是 CO

9、M 用来返回错误和成功代码的整型数字。除此之外，别无它意，虽然以 H作前缀，但没有句柄之意。下文会对它有更多的讨论。最后，COM 库是在你使用 COM 时与你交互的操作系统的一部分，它常常指的就是 COM 本身。但是为了避免混淆才分开描述的。使使用用和和处处理理 C CO OM M 对对象象每一种语言都有其自己处理对象的方式。例如，C+是在栈中创建对象，或者用 new 动态分配。因为COM 必须独立于语言，所以COM 库为自己提供对象管理例程。下面是对COM对象管理和 C+对象管理所做的一个比较：创建一个新对象C+中，用 new 操作符，或者在栈中创建对象。COM 中，调用 COM 库中的 A

10、PI。删除对象C+中，用 delete 操作符，或将栈对象踢出。COM 中，所有的对象保持它们自己的引用计数。调用者必须通知对象什么时候用完这个对象。当引用计数为零时，COM 对象将自己从内存中释放。由此可见，对象处理的两个阶段：创建和销毁，缺一不可。当创建 COM 对象时要通知COM 库使用哪一个接口。如果这个对象创建成功，COM 库返回所请求接口的指针。然后通过这个指针调用方法，就像使用常规 C+对象指针一样。创创建建 C CO OM M 对对象象为 了创建 COM 对象并 从这个 对象获 得接口，必 须调用 COM 库的 API 函数，CoCreateInstance()。其原型如下：H

11、RESULT CoCreateInstance(REFCLSIDrclsid,LPUNKNOWN pUnkOuter,DWORDdwClsContext,REFIIDriid,LPVOID*ppv);以下是参数解释：rclsidcoclass 的 CLSID，例如，可以传递 CLSID_ShellLink 创建一个 COM 对象来建立快捷方式。pUnkOuter这个参数只用于 COM 对象的聚合，利用它向现有的 coclass 添加新方法。参数值为 null 表示不使用聚合。dwClsContext表示所使用 COM 服务器的种类。本文使用的是最简单的 COM 服务器，一个进程内（in-pro

12、cess）DLL，所以传递的参数值为 CLSCTX_INPROC_SERVER。注意这里不要随意使用 CLSCTX_ALL（在 ATL 中，它是个缺省值），因为在没有安装 DCOM 的 Windows95 系统上会导致失败。riid请求接口的 IID。例如，可以传递 IID_IShellLink 获得 IShellLink 接口指针。ppv接口指针的地址。COM 库通过这个参数返回请求的接口。当你调用 CoCreateInstance()时，它负责在注册表中查找 COM 服务器的位置，将服务器加载到内存，并创建你所请求的 coclass 实例。以下是一个调用的例子，创建一个 CLSID_She

13、llLink 对象的实例并请求指向这个对象IShellLink 接口指针。HRESULThr;IShellLink*pISL;hr=CoCreateInstance(CLSID_ShellLink,/coclass 的 CLSIDNULL,/不是用聚合CLSCTX_INPROC_SERVER,/服务器类型IID_IShellLink,/接口的 IID(void*)&pISL);/指向接口的指针if(SUCCEEDED(hr)/用 pISL 调用方法else/不能创建 COM 对象，hr 为出错代码首先声明一个接受 CoCreateInstance()返回值的 HRESULT 和 IShellL

14、ink 指针。调用CoCreateInstance()来创建新的 COM 对象。如果 hr 接受到一个表示成功的代码，则SUCCEEDED 宏返回 TRUE，否则返回 FALSE。FAILED 是一个与 SUCCEEDED 对应的宏用来检查失败代码。删删除除 C CO OM M 对对象象前面说过，你不用释放 COM 对象，只要告诉它们你已经用完对象。IUnknown 是每一个COM 对象必须实现的接口，它有一个方法，Release()。调用这个方法通知 COM 对象你不再需要对象。一旦调用了这个方法之后，就不能再次使用这个接口，因为这个 COM 对象可能从此就从内存中消失了。如果你的应用程序使

15、用许多不同的 COM 对象，因此在用完某个接口后调用 Release()就显得非常重要。如果你不释放接口，这个 COM 对象（包含代码的 DLLs）将保留在内存中，这会增加不必要的开销。如果你的应用程序要长时间运行，就应该在应用程序处于空闲期间调用 CoFreeUnusedLibraries()API。这个 API 将卸载任何没有明显引用的 COM 服务器，因此这也降低了应用程序使用的内存开销。继续用上面的例子来说明如何使用 Release()：/像上面一样创建 COM 对象，然后，if(SUCCEEDED(hr)/用 pISL 调用方法/通知 COM 对象不再使用它pISL-Release(

16、);接下来将详细讨论 IUnknown 接口。基基本本接接口口I IU Un nk kn no ow wn n每一个COM 接口都派生于IUnknown。这个名字有点误导人，其中没有未知（Unknown）接口的意思。它的原意是如果有一个指向某 COM 对象的 IUnknown 指针，就不用知道潜在的对象是什么，因为每个 COM 对象都实现 IUnknown。IUnknown 有三个方法：AddRef()通知 COM 对象增加它的引用计数。如果你进行了一次接口指针的拷贝，就必须调用一次这个方法，并且原始的值和拷贝的值两者都要用到。在本文的例子中没有用到AddRef()方法。Release()通知

17、 COM 对象减少它的引用计数。参见前面的 Release()示例代码段。QueryInterface()从 COM 对象请求一个接口指针。当 coclass 实现一个以上的接口时，就要用到这个方法。前 面 已 经 看 到 了 Release()的 使 用，但 如 何 使 用 QueryInterface()呢?当 你 用CoCreateInstance()创建对象的时候，你得到一个返回的接口指针。如果这个 COM 对象实现一个以上的接口（不包括 IUnknown），你就必须用 QueryInterface()方法来获得任何你需要的附加的接口指针。QueryInterface()的原型如下：H

18、RESULT IUnknown:QueryInterface(REFIID iid,void*ppv);以下是参数解释：iid所请求的接口的 IID。ppv接口指针的地址，QueryInterface()通过这个参数在成功时返回这个接口。让我们继续外壳链接的例子。它实现了 IShellLink 和 IPersistFile 接口。如果你已经有一个IShellLink 指针，pISL，可以从 COM 对象请求 IPersistFile 接口：HRESULT hr;IPersistFile*pIPF;hr=pISL-QueryInterface(IID_IPersistFile,(void*)&p

19、IPF);然后使用 SUCCEEDED 宏检查 hr 的值以确定 QueryInterface()的调用情况，如果成功的话你就可以象使用其它接口指针那样使用新的接口指针，pIPF。但必须记住调用 pIPF-Release()通知 COM 对象已经用完这个接口。仔仔细细做做好好串串处处理理这一部分将花点时间来讨论如何在 COM 代码中处理串。如果你熟悉 Unicode 和 ANSI，并知道如何对它们进行转换的话，你就可以跳过这一部分，否则还是读一下这一部分的内容。不管什么时候，只要 COM 方法返回一个串，这个串都是 Unicode 串（这里指的是写入COM 规范的所有方法）。Unicode 是

20、一种字符编码集，类似 ASCII，但用两个字节表示一个字符。如果你想更好地控制或操作串的话，应该将它转换成 TCHAR 类型串。TCHAR 和以_t 开头的函数（如_tcscpy()）被设计用来让你用相同的源代码处理 Unicode和 ANSI 串。在大多数情况下编写的代码都是用来处理 ANSI 串和 ANSI WindowsAPIs，所以在下文中，除非另外说明，我所说的字符/串都是指 TCHAR类型。你应该熟练掌握 TCHAR类型，尤其是当你阅读其他人写的有关代码时，要特别注意 TCHAR 类型。当你从某个 COM 方法返回得到一个 Unicode 串时，可以用下列几种方法之一将它转换成ch

21、ar 类型串：1、调用 WideCharToMultiByte()API。2、调用 CRT 函数 wcstombs()。3、使用 CString 构造器或赋值操作(仅用于 MFC)。4、使用 ATL 串转换宏。WWi id de eC Ch ha ar rT To oM Mu ul lt ti iB By yt te e()你可以用 WideCharToMultiByte()将一个 Unicode 串转换成一个 ANSI 串。此函数的原型如下：int WideCharToMultiByte(UINTCodePage,DWORDdwFlags,LPCWSTR lpWideCharStr,intc

22、chWideChar,LPSTRlpMultiByteStr,intcbMultiByte,LPCSTRlpDefaultChar,LPBOOLlpUsedDefaultChar);以下是参数解释：CodePageUnicode 字符转换成的代码页。你可以传递 CP_ACP 来使用当前的 ANSI 代码页。代码页是256 个字符集。字符 0127 与 ANSI 编码一样。字符 128255 与 ANSI 字符不同，它可以包含图形字符或者读音符号。每一种语言或地区都有其自己的代码页，所以使用正确的代码页对于正确地显示重音字符很重要。dwFlagsdwFlags 确定 Windows 如何处理“复

23、合”Unicode 字符，它是一种后面带读音符号的字符。如就是一个复合字符。如果这些字符在 CodePage 参数指定的代码页中，不会出什么事。否则，Windows 必须对之进行转换。传递 WC_COMPOSITECHECK 使得这个 API 检查非映射复合字符。传递 WC_SEPCHARS 使得 Windows 将字符分为两段，即字符加读音，如 e。传递 WC_DISCARDNS 使得 Windows 丢弃读音符号。传递 WC_DEFAULTCHAR 使得 Windows 用 lpDefaultChar 参数中说明的缺省字符替代复合字符。缺省行为是 WC_SEPCHARS。lpWideCha

24、rStr要转换的 Unicode 串。cchWideCharlpWideCharStr 在 Unicode 字符中的长度。通常传递-1，表示这个串是以 0 x00 结尾。lpMultiByteStr接受转换的串的字符缓冲cbMultiBytelpMultiByteStr 的字节大小。lpDefaultChar可选当 dwFlags 包含 WC_COMPOSITECHECK|WC_DEFAULTCHAR 并且某个 Unicode字符不能被映射到同等的 ANSI 串时所传递的一个单字符 ANSI 串，包含被插入的“缺省”字符。可以传递 NULL，让 API 使用系统缺省字符（一种写法是一个问号）。

25、lpUsedDefaultChar可选指向 BOOL 类型的一个指针，设置它来表示是否缺省字符曾被插入 ANSI 串。可以传递 NULL 来忽略这个参数。我自己都有点晕菜了!，万事开头难啊，不搞清楚这些东西就很难搞清楚COM的串处理。何况文档中列出的比实际应用的要复杂得多。下面就给出了如何使用这个 API 的例子：/假设已经有了一个 Unicode 串 wszSomeString.char szANSIString MAX_PATH;WideCharToMultiByte(CP_ACP,/ANSI 代码页WC_COMPOSITECHECK,/检查重音字符wszSomeString,/原 Uni

26、code 串-1,/-1 意思是串以 0 x00 结尾szANSIString,/目的 char 字符串sizeof(szANSIString),/缓冲大小NULL,/肥缺省字符串NULL);/忽略这个参数调用这个函数后，szANSIString 将包含 Unicode 串的 ANSI 版本。w wc cs st to ommb bs s()这个 CRT 函数 wcstombs()是个简化版，但它终结了 WideCharToMultiByte()的调用，所以最终结果是一样的。其原型如下：size_t wcstombs(char*mbstr,const wchar_t*wcstr,size_tc

27、ount);以下是参数解释：mbstr接受结果 ANSI 串的字符（char）缓冲。wcstr要转换的 Unicode 串。countmbstr 参数所指的缓冲大小。wcstombs()在它对 WideCharToMultiByte()的调用中使用 WC_COMPOSITECHECK|WC_SEPCHARS 标志。用 wcstombs()转换前面例子中的 Unicode 串，结果一样：wcstombs(szANSIString,wszSomeString,sizeof(szANSIString);C CS St tr ri in ng gMFC 中的 CString 包含有构造函数和接受 Un

28、icode 串的赋值操作，所以你可以用 CString来实现转换。例如：/假设有一个 Unicode 串 wszSomeString.CString str1(wszSomeString);/用构造器转换CString str2;str2=wszSomeString;/用赋值操作转换A AT TL L 宏宏ATL 有一组很方便的宏用于串的转换。W2A()用于将 Unicode 串转换为 ANSI 串（记忆方法是“wide to ANSI”宽字符到 ANSI）。实际上使用 OLE2A()更精确，“OLE”表示的意思是 COM 串或者 OLE 串。下面是使用这些宏的例子：#include/还是假设

29、有一个 Unicode 串 wszSomeString.char szANSIString MAX_PATH;USES_CONVERSION;/声明这个宏要使用的局部变量lstrcpy(szANSIString,OLE2A(wszSomeString);OLE2A()宏“返回”转换的串的指针，但转换的串被存储在某个临时栈变量中，所以要用lstrcpy()来获得自己的拷贝。其它的几个宏是 W2T()（Unicode 到 TCHAR）以及 W2CT()（Unicode到常量 TCHAR 串）。有个宏是 OLE2CA()（Unicode 到常量 char 串），可以被用到上面的例子中，OLE2CA(

30、)实际上是个更正宏，因为 lstrcpy()的第二个参数是一个常量 char*，关于这个问题本文将在以后作详细讨论。另一方面，如果你不想做以上复杂的串处理，尽管让它还保持为 Unicode 串，如果编写的是控制台应用程序，输出/显示 Unicode 串时应该用全程变量 std:wcout，如：wcout wszSomeString;但是要记住，std:wcout 只认 Unicode，所以你要是“正常”串的话，还得用 std:cout 输出/显示。对于 Unicode 串文字量，要使用前缀 L 标示，如：wcout LThe Oracle says.endl GetWallpaper(wszW

31、allpaper,MAX_PATH,0);if(SUCCEEDED(hr)/4.如果 GetWallpaper()成功，则输出它返回的文件名字。/注意这里使用 wcout 来显示 Unicode 串 wszWallpaper.wcout 是/Unicode 专用，功能与 cout.相同。wcout LWallpaper path is:n wszWallpaper endl endl;elsecout _T(GetWallpaper()failed.)endl Release();elsecout _T(CoCreateInstance()failed.)endl SetPath(sWallp

32、aper);if(SUCCEEDED(hr)/4.获取这个对象的第二个接口(IPersistFile)。hr=pISL-QueryInterface(IID_IPersistFile,(void*)&pIPF);if(SUCCEEDED(hr)/5.调用 Save()方法保存某个文件得快捷方式。第一个参数是/Unicode 串。hr=pIPF-Save(LC:wallpaper.lnk,FALSE);/6a.释放 IPersistFile 接口。pIPF-Release();/6.释放 IShellLink 接口。pISL-Release();/输出错误信息部分这里省略。/7.收回 COM 库

33、。MFC 程序不用这一步，它自动完成。CoUninitialize();处处理理 H HR RE ES SU UL LT T这一部分准备用 SUCCEEDED 和 FAILED 宏进行一些简单的出错处理。主要是深入研究从 COM 方法返回的 HRESULT，以便达到完全理解和熟练应用。HRESULT 是个 32 位符号整数，其非负值表示成功，负值表示失败。HRESULT 有三个域：程度位（表示成功或失败），功能码和状态码。功能码表示 HRESULT 来自什么组件或程序。微软给不同的组件多赋予功能码，如：COM、任务调度程序等都有功能码。功能码是个 16 位的值，仅此而已，没有其它内在含义；它在

34、数字和意义之间是随意关联的；类似GetLastError()返回的值。如果你在 winerror.h 头文件中查找错误代码，会看到许多按照功能_程度_描述命名规范列出的 HRESULT 值，由组件返回的通用的 HRESULT（类似 E_OUTOFMEMORY）在名字中没有功能码。如，REGDB_E_READREGDB:功能码=REGDB,指“注册表数据库（registry database）”；程度=E 意思是错误（error）；描述=READREGDB 是对错误的描述（意思是不能读注册表数据库）。S_OK:没有功能码通用（generic）HRESULT；程度=S；表示成功（success）；

35、OK 是状态描述表示一切都好（everythings OK）。好在有一种比察看 winerror.h文件更容易的方法来确定 HRESULT 的意思。使用 VC 提供的错误查找工具（Error Lookup）可以轻松查到为 HRESULT 内建功能码。例如，假设你在CoCreateInstance()之前忘了调用 CoInitialize()。CoCreateInstance()返回的值是0 x800401F0。你只要将这个值输入到错误查找工具按“Look Up”按钮，便可以看到错误信息描述“尚未调用 CoInitialize”如下图所示：另外一种查找 HRESULT 描述的方法是在调试器中。假

36、设有一个 HRESULT 变量是 hres。在Watch 窗口的左边框中输入“hres,hr”，表示想要看的值，“hr”便会通知 VC 显示 HRESULT所描述的值。如下图所示：通过以上的讨论，想必你对 COM 编程有了初步的认识，本文第二部分将探讨 COM 的内部机制。教你如何用 C+编写自己的接口。本文为刚刚接触 COM 的程序员提供编程指南，解释 COM 服务器内幕以及如何用 C+编写自己的接口。继上一篇 COM 编程入门之后，本文将讨论有关 COM 服务器的内容，解释编写自己的COM 接口和 COM 服务器所需要的步骤和知识，以及详细讨论当 COM库对 COM 服务器进行调用时，CO

37、M 服务器运行的内部机制。如果你读过上一篇文章。应该很熟悉 COM 客户端是怎么会事了。本文将讨论 COM 的另一端COM 服务器。内容包括如何用C+编写一个简单的不涉及类库的COM 服务器。深入到创建 COM 服务器的内部过程，毫无遮掩地研究那些库代码是充分理解COM 服务器内部机制的最好方法。本文假设你精通 C+并掌握了上一篇文章所讨论的概念和术语。在这一部分将包括如下内容：走走马马观观花花看看 C CO OMM 服服务务器器描述 COM 服务器的基本要求。服服务务器器生生命命其其管管理理描述 COM 服务器如何控制加载时间。实实现现接接口口，从从 I IU Un nk kn no oww

38、n n 开开始始展示如何用 C+类编写一个接口实现并描述IUnknown 之方法的目的。深深入入 C Co oC Cr re ea at te eI In ns st ta an nc ce e()探究 CoCreateInstance()的调用机理。C CO OMM 服服务务器器的的注注册册描述完成服务器注册所需要的注册表入口。创创建建 C CO OMM 对对象象类工厂描述创建客户端要使用的 COM 对象的过程。一一个个定定制制接接口口的的例例子子例子代码示范了上述概念。一一个个使使用用服服务务器器的的客客户户端端举例说明一个简单的客户端应用程序，用它来测试 COM服务器。其其它它内内容容有

39、关源代码和调试的注释。走走马马观观花花看看 C CO OMM 服服务务器器本文我们将讨论最简单的一种 COM 服务器，进程内服务器（in-process）。“进程内”意思是服务器被加载到客户端程序的进程空间。进程内服务器都是 DLLs，并且与客户端程序同在一台计算机上。进程内服务器在被 COM 库使用之前必须满足两个条件或标准：1、必须正确在注册表的 HKEY_CLASSES_ROOTCLSID 键值下注册。2、必须输出 DllGetClassObject()函数。这是进程内服务器运行的最小需求。在注册表的 HKEY_CLASSES_ROOTCLSID 键值下必须创建一个键值，用服务器的GUI

40、D作为键名字，这个键值必须包含两个键值清单，一是服务器的位置，而是服务器的线程模型。COM 库对DllGetClassObject()函数进行调用是在 CoCreateInstance()API 中完成的。还有三个函数通常也要输出：o DllCanUnloadNow():由 COM 库调用来检查是否服务器被从内存中卸载。o DllRegisterServer():由类似 RegSvr32 的安装实用程序调用来注册服务器。o DllUnregisterServer():由卸载实用程序调用来删除由 DllRegisterServer()创建的注册表入口。另外，只输出正确的函数是不够的还必须遵循 C

41、OM 规范，这样 COM 库和客户端程序才能使用服务器。服服务务器器生生命命其其管管理理DLL 服务器的一个与众不同的方面是控制它们被加载的时间。“标准的”DLLs 被动的并且是在应用程序使用它们时被随机加载/或卸载。从技术上讲，DLL服务器也是被动的，因为不管怎样它们毕尽还是DLL，但 COM 库提供了一种机制，它允许某个服务器命令COM卸载它。这是通过输出函数DllCanUnloadNow()实现的。这个函数的原型如下：HRESULT DllCanUnloadNow();当客户应用程序调用 COM API CoFreeUnusedLibraries()时，通常出于其空闲处理期间，COM 库

42、遍历这个客户端应用已加载所有的 DLL 服务器并通过调用它的DllCanUnloadNow()函数查询每一个服务器。另一方面，如果某个服务器确定它不再需要驻留内存，它可以返回 S_OK 让 COM 将它卸载。服务器通过简单的引用计数来确定它是否能被卸载。下面是DllCanUnloadNow()的实现：extern UINT g_uDllRefCount;/服务器的引用计数 HRESULTDllCanUnloadNow()return(g_uDllRefCount 0)?S_FALSE:S_OK;如何处理引用计数将在下一节涉及到具体代码时讨论。实实现现接接口口，从从 I IU Un nk kn

43、no owwn n 开开始始有必要回想一下IUnknown派生的每一个接口。因为 IUnknown 包含了两个 COM 对象的基本特性引用计数和接口查询。当你编写组件对象类时（coclass），还要写一个满足自己需要的 IUnknown 实现。以实现 IUnknown 接口的组件对象类为例下面这个例子可能是你编写的最简单的一个组件对象类。我们将在一个叫做CUnknownImpl 的 C+类中实现 IUnknown。下面是这个类的声明：class CUnknownImpl:public IUnknownpublic:/构造函数和析构器CUnknownImpl();virtual CUnknown

44、Impl();/IUnknown 方法ULONG AddRef();ULONG Release)();HRESULT QueryInterface(REFIID riid,void*ppv);protected:UINT m_uRefCount;/对象的引用计数;构构造造器器和和析析构构器器构造器和析构器管理服务器的引用计数：CUnknownImpl:CUnknownImpl()m_uRefCount=0;g_uDllRefCount+;CUnknownImpl:CUnknownImpl()g_uDllRefCount-;当创建新的 COM 对象时，构造器被调用，它增加服务器的引用计数以保持这

45、个服务器驻留内存。同时它还将对象的引用计数初始化为零。当这个 COM 对象被摧毁时，它减少服务器的引用计数。AddRef()和 Release()这两个方法控制 COM 对象的生命期。AddRef()很简单：ULONG CUnknownImpl:AddRef()return+m_uRefCount;AddRef()只增加对象的引用计数并返回更新的计数。Release()更简单：ULONGCUnknownImpl:Release()ULONG uRet=-m_uRefCount;if(0=m_uRefCount)/是否释放了最后的引用?delete this;returnuRet;除了减少对象的

46、引用计数外，如果没有另外的明确引用，Release()将摧毁对象。Release()也返回更新的引用计数。注意Release()的实现假设COM对象在堆中创建。如果你在全局粘上创建某个对象，当对象试图删除自己时就会出问题。现在应该明白了为什么在客户端应用程序中正确调用 AddRef()和 Release()是如此重要！如果在这了做得不对，你使用的对象会被很快摧毁，这样的话在整个服务器中内存会很快溢出导致应用程序下次存取服务器代码时崩溃。如果你编写多线程应用，可能会想到使用+&替代 InterlockedIncrement()和InterlockedDecrement()的线程安全问题。+&用于

47、单线程服务器很保险，因为即使客户端应用是多线程的并从不同的线程中进行方法调用，COM 库都会按顺序进行服务器的方法调用。也就是说，一旦一个方法调用开始，所有其它试图调用方法的线程都将阻塞，直到第一个方法返回。COM 库本身确保服务器一次不会被一个以上的线程闯入。Q Qu ue er ry yI In nt te er rf fa ac ce e()QueryInterface()简称 QI()，由客户端程序调用这个函数从 COM 对象请求不同的接口。我们在例子代码中因为只实现一个接口，QI()会很容易使用。QI()有两个参数：一个是所请求的接口IID，一个是指针的缓冲大小，如果查询成功，QI(

48、)将接口指针地址存储在这个缓冲指针中。HRESULT CUnknownImpl:QueryInterface(REFIID riid,void*ppv)HRESULT hrRet=S_OK;/标准 QI()初始化 置*ppv 为 NULL.*ppv=NULL;/如果客户端请求提供的接口，给*ppv.赋值if(IsEqualIID(riid,IID_IUnknown)*ppv=(IUnknown*)this;else/不提供客户端请求的接口hrRet=E_NOINTERFACE;/如果返回一个接口指针。调用AddRef()增加引用计数.if(S_OK=hrRet)(IUnknown*)*ppv)

49、-AddRef();return hrRet;在 QI()中做了三件不同的事情：1、初始化传入的指针为NULL*ppv=NULL;。2、检查riid，确定组件对象类（coclass）实现了客户端所请求接口.if(IsEqualIID(riid,IID_IUnknown)3、如果确实实现勒索请求的接口，则增加 COM 对象的引用计数。(IUnknown*)*ppv)-AddRef();AddRef()调用很关键。*ppv=(IUnknown*)this;要创建新的 COM 对象引用，就必须调用这个函数通知 COM 对象这个新引用成立。在AddRef()调用中的强制转换 IUnknown*看起来好

50、像多余，但是在 QI()中初始化的*ppv 有可能不是 IUnknown*类型，所以最好是养成习惯对之进行强行转换。上面我们已经讨论了一些 DLL 服务器的内部细节，接下来让我们回头看一看当客户端调用 CoCreateInstance()时是如何处理服务器的。深深入入 C Co oC Cr re ea at te eI In ns st ta an nc ce e()在本文的第一部分中，我们见过 CoCreateInstance()API，其作用是当客户端请求对象时，用它来创建对象。从客户端的立场看，它是一个黑盒子。只要用正确的参数调用它即可得到一个 COM 对象。它并没有什么魔法，只是在一个