COM编程入门

本文的目的是为刚刚接触COM的程序员提供编程指南&＃xff0c;并帮助他们理解COM的基本概念。内容包括COM规范简介&＃xff0c;重要的COM术语以及如何重用现有的COM组件。本文不包括如何编写自己的COM对象和接口。
　　COM即组件对象模型&＃xff0c;是Component Object Model 取前三个字母的缩写&＃xff0c;这三个字母在当今Windows的世界中随处可见。随时涌现出来的大把大把的新技术都以COM为基础。各种文档中也充斥着诸如COM对象、接口、服务器之类的术语。因此&＃xff0c;对于一个程序员来说&＃xff0c;不仅要掌握使用COM的方法&＃xff0c;而且还要彻底熟悉COM的所有一切。
　　本文由浅入深描述COM的内在运行机制&＃xff0c;教你如何使用第三方提供的COM对象&＃xff08;以Windows 外壳组件Shell为例&＃xff09;。读完本文后&＃xff0c;你就能掌握如何使用Windows操作系统中内建的组件和第三方提供的COM对象。
　　本文假设你精通C&＃43;&＃43;语言。在例子代码中使用了一点MFC和ATL&＃xff0c;如果你不熟悉MFC和ATL也没关系&＃xff0c;本文会对这些代码进行完全透彻的解释。本文包括以下几个部分&＃xff1a;

1. COM——到底是什么&＃xff1f;——COM标准的要点介绍&＃xff0c;它被设计用来解决什么问题 
2. 基本元素的定义——COM术语以及这些术语的含义 
   
3. 使用和处理COM对象——如何创建、使用和销毁COM对象 
   
4. 基本接口——描述IUnknown基本接口及其方法 
   
5. 掌握串的处理——在COM代码中如何处理串 
   
6. 应用COM技术——例子代码&＃xff0c;举例说明本文所讨论的所有概念 
   
7. 处理HRESULT——HRESULT类型描述&＃xff0c;如何监测错误及成功代码 

COM——到底是什么 

　　简单地说&＃xff0c;COM是一种跨应用和语言共享二进制代码的方法。与C&＃43;&＃43;不同&＃xff0c;它提倡源代码重用。ATL便是一个很好的例证。源码级重用虽然好&＃xff0c;但只能用于C&＃43;&＃43;。它还带来了名字冲突的可能性&＃xff0c;更不用说不断拷贝重用代码而导致工程膨胀和臃肿。

　　Windows使用DLLs在二进制级共享代码。这也是Windows程序运行的关键——重用kernel32.dll, user32.dll等。但DLLs是针对C接口而写的&＃xff0c;它们只能被C或理解C调用规范的语言使用。由编程语言来负责实现共享代码&＃xff0c;而不是由DLLs本身。这样的话DLLs的使用受到限制。

MFC引入了另外一种MFC扩展DLLs二进制共享机制。但它的使用仍受限制——只能在MFC程序中使用。

　　COM通过定义二进制标准解决了这些问题&＃xff0c;即COM明确指出二进制模块&＃xff08;DLLs和EXEs&＃xff09;必须被编译成与指定的结构匹配。这个标准也确切规定了在内存中如何组织COM对象。COM定义的二进制标准还必须独立于任何编程语言&＃xff08;如C&＃43;&＃43;中的命名修饰&＃xff09;。一旦满足了这些条件&＃xff0c;就可以轻松地从任何编程语言中存取这些模块。由编译器负责所产生的二进制代码与标准兼容。这样使后来的人就能更容易地使用这些二进制代码。

　　在内存中&＃xff0c;COM对象的这种标准形式在C&＃43;&＃43;虚函数中偶尔用到&＃xff0c;所以这就是为什么许多COM代码使用C&＃43;&＃43;的原因。但是记住&＃xff0c;编写模块所用的语言是无关的&＃xff0c;因为结果二进制代码为所有语言可用。

　　此外&＃xff0c;COM不是Win32特有的。从理论上讲&＃xff0c;它可以被移植到Unix或其它操作系统。但是我好像还从来没有在Windows以外的地方听说过COM。

基本元素的定义

　　我们从下往上看。接口只不过是一组函数。这些函数被称为方法。接口名字以大写的I开头&＃xff0c;例如C&＃43;&＃43;中的IShellLink&＃xff0c;接口被设计成一个抽象基类&＃xff0c;其中只有纯粹的虚拟函数。

　　接口可以从其它接口继承&＃xff0c;这里所说的继承的原理就好像C&＃43;&＃43;中的单继承。接口是不允许多继承的。

coclass&＃xff08;简称组件对象类——component object class&＃xff09;被包含在DLL或EXE中&＃xff0c;并且包含着一个或者多个接口的代码。组件对象类&＃xff08;coclasss&＃xff09;实现这些接口。COM对象在内存中表现为组件对象类&＃xff08;coclasss&＃xff09;的一个实例。注意COM“类”和C&＃43;&＃43;“类”是不相同的&＃xff0c;尽管常常COM类实现的就是一个C&＃43;&＃43;类。 



COM服务器是包含了一个或多个coclass的二进制&＃xff08;DLL或EXE&＃xff09;。



注册&＃xff08;Registration&＃xff09;是创建注册表入口的一个过程&＃xff0c;告诉Windows 操作系统COM服务器放在什么位置。取消注册&＃xff08;Unregistration&＃xff09;则相反——从注册表删除这些注册入口。





GUID&＃xff08;谐音为“fluid”&＃xff0c;意思是全球唯一标示符——globally unique identifier&＃xff09;是个128位的数字。它是一种独立于COM编程语言的标示方法。每一个接口和coclass有一个GUID。因为每一个GUID都是全球唯一的&＃xff0c;所以避免了名字冲突&＃xff08;只要你用COM API创建它们&＃xff09;。有时你还会碰到另一个术语UUID&＃xff08;意思也是全球唯一标示符——universally unique identifier&＃xff09;。UUIDs和GUIDs在实际使用时的用途是一样的。



类ID或者CLSID是命名coclass的GUID。接口ID或者IID是命名接口的GUID。



在COM中广泛地使用GUID有两个理由&＃xff1a;

1.
GUIDs只是简单的数字&＃xff0c;任何编程语言都可以对之进行处理&＃xff1b; 

2.
GUIDs可以在任何机器上被任何人创建&＃xff0c;一旦完成创建&＃xff0c;它就是唯一的。因此&＃xff0c;COM开发人员可以创建自己特有的GUIDs而不会与其它开发人员所创建的GUIDs有冲突。这样就消除了集中授权发布GUIDs的必要。 

　　HRESULT是COM用来返回错误和成功代码的整型数字。除此之外&＃xff0c;别无它意&＃xff0c;虽然以H作前缀&＃xff0c;但没有句柄之意。下文会对它有更多的讨论。

　　最后&＃xff0c;COM库是在你使用COM时与你交互的操作系统的一部分&＃xff0c;它常常指的就是COM本身。但是为了避免混淆才分开描述的。

使用和处理COM对象

　　每一种语言都有其自己处理对象的方式。例如&＃xff0c;C&＃43;&＃43;是在栈中创建对象&＃xff0c;或者用new动态分配。因为COM必须独立于语言&＃xff0c;所以COM库为自己提供对象管理例程。下面是对COM对象管理和C&＃43;&＃43;对象管理所做的一个比较&＃xff1a;

创建一个新对象

C&＃43;&＃43;中&＃xff0c;用new操作符&＃xff0c;或者在栈中创建对象。

COM中&＃xff0c;调用COM库中的API。

删除对象

C&＃43;&＃43;中&＃xff0c;用delete操作符&＃xff0c;或将栈对象踢出。

COM中&＃xff0c;所有的对象保持它们自己的引用计数。调用者必须通知对象什么时候用完这个对象。当引用计数为零时&＃xff0c;COM对象将自己从内存中释放。

　　由此可见&＃xff0c;对象处理的两个阶段&＃xff1a;创建和销毁&＃xff0c;缺一不可。当创建COM对象时要通知COM库使用哪一个接口。如果这个对象创建成功&＃xff0c;COM库返回所请求接口的指针。然后通过这个指针调用方法&＃xff0c;就像使用常规C&＃43;&＃43;对象指针一样。

创建COM对象

为了创建COM对象并从这个对象获得接口&＃xff0c;必须调用COM库的API函数&＃xff0c;CoCreateInstance()。其原型如下&＃xff1a; 

HRESULT CoCreateInstance (REFCLSID rclsid,LPUNKNOWN pUnkOuter,DWORD dwClsContext,REFIID riid,LPVOID* ppv );



以下是参数解释&＃xff1a; 

rclsid&＃xff1a;coclass的CLSID&＃xff0c;例如&＃xff0c;可以传递CLSID_ShellLink创建一个COM对象来建立快捷方式。

pUnkOuter&＃xff1a;这个参数只用于COM对象的聚合&＃xff0c;利用它向现有的coclass添加新方法。参数值为null表示不使用聚合。

dwClsContext&＃xff1a;表示所使用COM服务器的种类。本文使用的是最简单的COM服务器&＃xff0c;一个进程内&＃xff08;in-process&＃xff09;DLL&＃xff0c;

　　　　　　　　所以传递的参数值为CLSCTX_INPROC_SERVER。注意这里不要随意使用CLSCTX_ALL&＃xff08;在ATL中&＃xff0c;它是个缺省值&＃xff09;&＃xff0c;

　　　　　　　　因为在没有安装DCOM的Windows95系统上会导致失败。

riid&＃xff1a;请求接口的IID。例如&＃xff0c;可以传递IID_IShellLink获得IShellLink接口指针。

ppv&＃xff1a;接口指针的地址。COM库通过这个参数返回请求的接口。


　　当你调用CoCreateInstance()时&＃xff0c;它负责在注册表中查找COM服务器的位置&＃xff0c;将服务器加载到内存&＃xff0c;并创建你所请求的coclass实例。以下是一个调用的例子&＃xff0c;创建一个CLSID_ShellLink对象的实例并请求指向这个对象IShellLink接口指针。 

HRESULT hr;
IShellLink* pISL;hr &＃61; CoCreateInstance ( CLSID_ShellLink, // coclass 的CLSID NULL, // 不是用聚合CLSCTX_INPROC_SERVER, // 服务器类型IID_IShellLink, // 接口的IID (void**) &pISL ); // 指向接口的指针if ( SUCCEEDED ( hr ) ){// 用pISL调用方法}else{// 不能创建COM对象&＃xff0c;hr 为出错代码}



　　首先声明一个接受CoCreateInstance()返回值的HRESULT和IShellLink指针。调用CoCreateInstance()来创建新的COM对象。如果hr接受到一个表示成功的代码&＃xff0c;则SUCCEEDED宏返回TRUE&＃xff0c;否则返回FALSE。FAILED是一个与SUCCEEDED对应的宏用来检查失败代码。 

删除COM对象 

　　前面说过&＃xff0c;你不用释放COM对象&＃xff0c;只要告诉它们你已经用完对象。IUnknown是每一个COM对象必须实现的接口&＃xff0c;它有一个方法&＃xff0c;Release()。调用这个方法通知COM对象你不再需要对象。一旦调用了这个方法之后&＃xff0c;就不能再次使用这个接口&＃xff0c;因为这个COM对象可能从此就从内存中消失了。

　　如果你的应用程序使用许多不同的COM对象&＃xff0c;因此在用完某个接口后调用Release()就显得非常重要。如果你不释放接口&＃xff0c;这个COM对象&＃xff08;包含代码的DLLs&＃xff09;将保留在内存中&＃xff0c;这会增加不必要的开销。如果你的应用程序要长时间运行&＃xff0c;就应该在应用程序处于空闲期间调用CoFreeUnusedLibraries() API。这个API将卸载任何没有明显引用的COM服务器&＃xff0c;因此这也降低了应用程序使用的内存开销。

继续用上面的例子来说明如何使用Release()&＃xff1a; 

// 像上面一样创建COM 对象&＃xff0c; 然后if ( SUCCEEDED ( hr ) ){// 用pISL调用方法// 通知COM 对象不再使用它pISL->Release();}



接下来将详细讨论IUnknown接口。 

基本接口——IUnknown

　　每一个COM接口都派生于IUnknown。这个名字有点误导人&＃xff0c;其中没有未知&＃xff08;Unknown&＃xff09;接口的意思。它的原意是如果有一个指向某COM对象的IUnknown指针&＃xff0c;就不用知道潜在的对象是什么&＃xff0c;因为每个COM对象都实现IUnknown。

IUnknown 有三个方法&＃xff1a;

1. AddRef() —— 通知COM对象增加它的引用计数。如果你进行了一次接口指针的拷贝&＃xff0c;就必须调用一次这个方法&＃xff0c;并且原始的值和拷贝的值两者都要用到。在本文的例子中没有用到AddRef()方法&＃xff1b; 
2. Release() —— 通知COM对象减少它的引用计数。参见前面的Release()示例代码段&＃xff1b; 
   
3. QueryInterface() —— 从COM对象请求一个接口指针。当coclass实现一个以上的接口时&＃xff0c;就要用到这个方法&＃xff1b; 

　　前面已经看到了Release()的使用&＃xff0c;但如何使用QueryInterface()呢?当你用CoCreateInstance()创建对象的时候&＃xff0c;你得到一个返回的接口指针。如果这个COM对象实现一个以上的接口&＃xff08;不包括IUnknown&＃xff09;&＃xff0c;你就必须用QueryInterface()方法来获得任何你需要的附加的接口指针。QueryInterface()的原型如下&＃xff1a; 

HRESULT IUnknown::QueryInterface (REFIID iid,void** ppv );



以下是参数解释&＃xff1a;

iid&＃xff1a;所请求的接口的IID。

ppv&＃xff1a;接口指针的地址&＃xff0c;QueryInterface()通过这个参数在成功时返回这个接口。

　　让我们继续外壳链接的例子。它实现了IShellLink 和IPersistFile接口。如果你已经有一个IShellLink指针&＃xff0c;pISL&＃xff0c;可以从COM对象请求IPersistFile接口&＃xff1a; 

HRESULT hr;

IPersistFile* pIPF;

hr &＃61; pISL->QueryInterface ( IID_IPersistFile, (void**) &pIPF );

　　然后使用SUCCEEDED宏检查hr的值以确定QueryInterface()的调用情况&＃xff0c;如果成功的话你就可以象使用其它接口指针那样使用新的接口指针&＃xff0c;pIPF。但必须记住调用pIPF->Release()通知COM对象已经用完这个接口。 

仔细做好串处理

　　这一部分将花点时间来讨论如何在COM代码中处理串。如果你熟悉Unicode 和ANSI&＃xff0c;并知道如何对它们进行转换的话&＃xff0c;你就可以跳过这一部分&＃xff0c;否则还是读一下这一部分的内容。

　　不管什么时候&＃xff0c;只要COM方法返回一个串&＃xff0c;这个串都是Unicode串&＃xff08;这里指的是写入COM规范的所有方法&＃xff09;。Unicode是一种字符编码集&＃xff0c;类似ASCII&＃xff0c;但用两个字节表示一个字符。如果你想更好地控制或操作串的话&＃xff0c;应该将它转换成TCHAR类型串。

　　TCHAR和以_t开头的函数&＃xff08;如_tcscpy()&＃xff09;被设计用来让你用相同的源代码处理Unicode和ANSI串。在大多数情况下编写的代码都是用来处理ANSI串和ANSI WindowsAPIs&＃xff0c;所以在下文中&＃xff0c;除非另外说明&＃xff0c;我所说的字符/串都是指TCHAR类型。你应该熟练掌握TCHAR类型&＃xff0c;尤其是当你阅读其他人写的有关代码时&＃xff0c;要特别注意TCHAR类型。

　　当你从某个COM方法返回得到一个Unicode串时&＃xff0c;可以用下列几种方法之一将它转换成char类型串&＃xff1a;

1.
调用 WideCharToMultiByte() API&＃xff1b; 

2.
调用CRT 函数wcstombs()&＃xff1b; 

3.
使用CString 构造器或赋值操作(仅用于MFC )&＃xff1b; 

4.
使用ATL 串转换宏&＃xff1b; 

WideCharToMultiByte()

你可以用WideCharToMultiByte()将一个Unicode串转换成一个ANSI串。此函数的原型如下&＃xff1a; 

int WideCharToMultiByte (UINT CodePage,DWORD dwFlags,LPCWSTR lpWideCharStr,int cchWideChar,LPSTR lpMultiByteStr,int cbMultiByte,LPCSTR lpDefaultChar,LPBOOL lpUsedDefaultChar );



以下是参数解释&＃xff1a; 


CodePage&＃xff1a;Unicode字符转换成的代码页。你可以传递CP_ACP来使用当前的ANSI代码页。代码页是256个字符集。字符0——127与ANSI编码一样。字符128——255与ANSI字符不同&＃xff0c;它可以包含图形字符或者读音符号。每一种语言或地区都有其自己的代码页&＃xff0c;所以使用正确的代码页对于正确地显示重音字符很重要。 


dwFlags&＃xff1a;dwFlags 确定Windows如何处理“复合” Unicode字符&＃xff0c;它是一种后面带读音符号的字符。

如è就是一个复合字符。如果这些字符在CodePage参数指定的代码页中&＃xff0c;不会出什么事。

否则&＃xff0c;Windows必须对之进行转换。传递WC_COMPOSITECHECK使得这个API检查非映射复合字符。

传递WC_SEPCHARS使得Windows将字符分为两段&＃xff0c;即字符加读音&＃xff0c;如e&＃96;。

传递WC_DISCARDNS使得Windows丢弃读音符号。

传递WC_DEFAULTCHAR使得Windows用lpDefaultChar参数中说明的缺省字符替代复合字符。

缺省行为是WC_SEPCHARS。 


lpWideCharStr 要转换的Unicode串。 


cchWideChar lpWideCharStr在Unicode 字符中的长度。通常传递-1&＃xff0c;表示这个串是以0x00结尾。 


lpMultiByteStr 接受转换的串的字符缓冲 cbMultiByte lpMultiByteStr的字节大小。 


lpDefaultChar 可选——当dwFlags包含WC_COMPOSITECHECK | WC_DEFAULTCHAR并且某个Unicode字符不能被映射到同等的ANSI串时所传递的一个单字符ANSI串&＃xff0c;包含被插入的“缺省”字符。可以传递NULL&＃xff0c;让API使用系统缺省字符&＃xff08;一种写法是一个问号&＃xff09;。 


lpUsedDefaultChar 可选——指向BOOL类型的一个指针&＃xff0c;设置它来表示是否缺省字符曾被插入ANSI串。可以传递NULL来忽略这个参数。 

　　我自己都有点晕菜了……!&＃xff0c;万事开头难啊……&＃xff0c;不搞清楚这些东西就很难搞清楚COM的串处理。何况文档中列出的比实际应用的要复杂得　多。下面就给出了如何使用这个API的例子&＃xff1a; 

// 假设已经有了一个Unicode 串 wszSomeString...
char szANSIString [MAX_PATH];WideCharToMultiByte ( CP_ACP, // ANSI 代码页WC_COMPOSITECHECK, // 检查重音字符wszSomeString, // 原Unicode 串-1, // -1 意思是串以0x00结尾szANSIString, // 目的char字符串sizeof(szANSIString), // 缓冲大小NULL, // 肥缺省字符串NULL ); // 忽略这个参数



调用这个函数后&＃xff0c;szANSIString将包含Unicode串的ANSI版本。调用这个函数后&＃xff0c;szANSIString将包含Unicode串的ANSI版本。 

wcstombs()

这个CRT函数wcstombs()是个简化版&＃xff0c;但它终结了WideCharToMultiByte()的调用&＃xff0c;所以最终结果是一样的。其原型如下&＃xff1a; 

size_t wcstombs (char* mbstr,const wchar_t* wcstr,size_t count );



以下是参数解释&＃xff1a; 

mbstr&＃xff1a;接受结果ANSI串的字符&＃xff08;char&＃xff09;缓冲。

wcstr&＃xff1a;要转换的Unicode串。

count&＃xff1a;mbstr参数所指的缓冲大小。

　　wcstombs()在它对WideCharToMultiByte()的调用中使用WC_COMPOSITECHECK | WC_SEPCHARS标志。用wcstombs()转换前面例子中的Unicode串&＃xff0c;结果一样&＃xff1a; 

wcstombs ( szANSIString, wszSomeString, sizeof(szANSIString) );

CString 

MFC中的CString包含有构造函数和接受Unicode串的赋值操作&＃xff0c;所以你可以用CString来实现转换。例如&＃xff1a; 

// 假设有一个Unicode串wszSomeString...CString str1 ( wszSomeString ); // 用构造器转换
CString str2;str2 &＃61; wszSomeString; // 用赋值操作转换



ATL宏 

　　ATL有一组很方便的宏用于串的转换。W2A()用于将Unicode串转换为ANSI串&＃xff08;记忆方法是“wide to ANSI”——宽字符到ANSI&＃xff09;。实际上使用OLE2A()更精确&＃xff0c;“OLE”表示的意思是COM串或者OLE串。下面是使用这些宏的例子&＃xff1a; 

#include // 还是假设有一个Unicode串wszSomeString...{
char szANSIString [MAX_PATH];
USES_CONVERSION; // 声明这个宏要使用的局部变量lstrcpy ( szANSIString, OLE2A(wszSomeString) );
}

　　OLE2A()宏“返回”转换的串的指针&＃xff0c;但转换的串被存储在某个临时栈变量中&＃xff0c;所以要用lstrcpy()来获得自己的拷贝。其它的几个宏是W2T()&＃xff08;Unicode 到 TCHAR&＃xff09;以及W2CT()&＃xff08;Unicode到常量TCHAR串&＃xff09;。

　　有个宏是OLE2CA()&＃xff08;Unicode到常量char串&＃xff09;&＃xff0c;可以被用到上面的例子中&＃xff0c;OLE2CA()实际上是个更正宏&＃xff0c;因为lstrcpy()的第二个参数是一个常量char*&＃xff0c;关于这个问题本文将在以后作详细讨论。

　　另一方面&＃xff0c;如果你不想做以上复杂的串处理&＃xff0c;尽管让它还保持为Unicode串&＃xff0c;如果编写的是控制台应用程序&＃xff0c;输出/显示Unicode串时应该用全程变量std::wcout&＃xff0c;如&＃xff1a; 

wcout <
　　但是要记住&＃xff0c;std::wcout只认Unicode&＃xff0c;所以你要是“正常”串的话&＃xff0c;还得用std::cout输出/显示。对于Unicode串文字量&＃xff0c;要使用前缀L标示&＃xff0c;如&＃xff1a; 

wcout <
如果保持串为Unicode&＃xff0c;编程时有两个限制&＃xff1a; 


必须使用wcsXXX() Unicode串处理函数&＃xff0c;如wcslen()&＃xff1b; 


在Windows 9x环境中不能在Windows API中传递Unicode串。要想编写能在9x和NT上都能运行的应用&＃xff0c;必须使用TCHAR类型&＃xff0c;详情请参 考MSDN&＃xff1b; 

用例子代码总结上述内容 

下面用两个例子演示本文所讲的COM概念。代码中还包含了本文的例子工程。

使用单接口COM对象

　　第一个例子展示的是单接口COM对象。这可能是你碰到得最简单的例子。它使用外壳中的活动桌面组件对象类&＃xff08;CLSID_ActiveDesktop&＃xff09;来获得当前桌面墙纸的文件名。请确认系统中安装了活动桌面&＃xff08;Active Desktop&＃xff09;。 以下是编程步骤&＃xff1a;

1. 初始化COM库。 &＃xff08;Initialize&＃xff09;&＃xff1b; 
2. 创建一个与活动桌面交互的COM对象&＃xff0c;并取得IActiveDesktop接口&＃xff1b; 
3. 调用COM对象的GetWallpaper()方法&＃xff1b; 
4. 如果GetWallpaper()成功&＃xff0c;则输出/显示墙纸文件名&＃xff1b; 
5. 释放接口&＃xff08;Release()&＃xff09;&＃xff1b; 
6. 收回COM库&＃xff08;Uninitialize&＃xff09;&＃xff1b; 

WCHAR wszWallpaper [MAX_PATH];
CString strPath;
HRESULT hr;
IActiveDesktop* pIAD;// 1. 初始化COM库&＃xff08;让Windows加载DLLs&＃xff09;。通常是在程序的InitInstance()中调用// CoInitialize ( NULL )或其它启动代码。MFC程序使用AfxOleInit()。CoInitialize ( NULL );// 2. 使用外壳提供的活动桌面组件对象类创建COM对象。// 第四个参数通知COM需要什么接口(这里是IActiveDesktop).hr &＃61; CoCreateInstance ( CLSID_ActiveDesktop,NULL,CLSCTX_INPROC_SERVER,IID_IActiveDesktop,(void**) &pIAD );if ( SUCCEEDED(hr) ){// 3. 如果COM对象被创建成功&＃xff0c;则调用这个对象的GetWallpaper() 方法。hr &＃61; pIAD->GetWallpaper ( wszWallpaper, MAX_PATH, 0 );if ( SUCCEEDED(hr) ){// 4. 如果 GetWallpaper() 成功&＃xff0c;则输出它返回的文件名字。// 注意这里使用wcout 来显示Unicode 串wszWallpaper. wcout 是// Unicode 专用&＃xff0c;功能与cout.相同。wcout <Release();}else{cout <<_T("CoCreateInstance() failed.") <



　　在这个例子中&＃xff0c;输出/显示Unicode 串 wszWallpaper用的是std::wcout。 

使用多接口的COM对象 

　　第二个例子展示了如何使用一个提供单接口的COM对象QueryInterface()函数。其中的代码用外壳的Shell Link组件对象类创建我们在第一个例子中获得的墙纸文件的快捷方式 。以下是编程步骤&＃xff1a;




1. 初始化 COM 库&＃xff1b; 
2. 创建一个用于建立快捷方式的COM 对象并取得IShellLink 接口&＃xff1b; 
3. 调用IShellLink 接口的SetPath()方法&＃xff1b; 
4. 调用对象的QueryInterface()函数并取得IPersistFile接口&＃xff1b; 
5. 调用IPersistFile 接口的Save()方法&＃xff1b; 
6. 释放接口&＃xff1b; 
7. 收回COM库&＃xff1b; 

CString sWallpaper &＃61; wszWallpaper; // 将墙纸路径转换为ANSI
IShellLink* pISL;
IPersistFile* pIPF;// 1. 初始化COM库(让Windows 加载DLLs). 通常在InitInstance()中调用// CoInitialize ( NULL )或其它启动代码。MFC 程序使用AfxOleInit() 。CoInitialize ( NULL );// 2. 使用外壳提供的Shell Link组件对象类创建COM对象。.// 第四个参数通知COM 需要什么接口(这里是IShellLink)。hr &＃61; CoCreateInstance ( CLSID_ShellLink,NULL,CLSCTX_INPROC_SERVER,IID_IShellLink,(void**) &pISL );if ( SUCCEEDED(hr) ){// 3. 设置快捷方式目标(墙纸文件)的路径。hr &＃61; pISL->SetPath ( sWallpaper );if ( SUCCEEDED(hr) ){// 4. 获取这个对象的第二个接口(IPersistFile)。hr &＃61; pISL->QueryInterface ( IID_IPersistFile, (void**) &pIPF );if ( SUCCEEDED(hr) ){// 5. 调用Save() 方法保存某个文件得快捷方式。第一个参数是// Unicode 串。hr &＃61; pIPF->Save ( L"C:\\wallpaper.lnk", FALSE );// 6a. 释放IPersistFile 接口。pIPF->Release();}}// 6. 释放IShellLink 接口。pISL->Release();}// 输出错误信息部分这里省略。// 7. 收回COM 库。MFC 程序不用这一步&＃xff0c;它自动完成。CoUninitialize();



处理HRESULT 

　　这一部分准备用SUCCEEDED 和 FAILED宏进行一些简单的出错处理。主要是深入研究从COM方法返回的HRESULT&＃xff0c;以便达到完全理解和熟练应用。

　　HRESULT是个32位符号整数&＃xff0c;其非负值表示成功&＃xff0c;负值表示失败。HRESULT有三个域&＃xff1a;程度位&＃xff08;表示成功或失败&＃xff09;&＃xff0c;功能码和状态码。功能码表示HRESULT来自什么组件或程序。微软给不同的组件多赋予功能码&＃xff0c;如&＃xff1a;COM、任务调度程序等都有功能码。功能码是个16位的值&＃xff0c;仅此而已&＃xff0c;没有其它内在含义&＃xff1b;它在数字和意义之间是随意关联的&＃xff1b;类似GetLastError()返回的值。

　　如果你在winerror.h头文件中查找错误代码&＃xff0c;会看到许多按照[功能]_[程度]_[描述]命名规范列出的HRESULT值&＃xff0c;由组件返回的通用的HRESULT&＃xff08;类似E_OUTOFMEMORY&＃xff09;在名字中没有功能码。如 &＃xff1a;

REGDB_E_READREGDB&＃xff1a;

功能码 &＃61; REGDB, 指“注册表数据库&＃xff08;registry database&＃xff09;”&＃xff1b;

程度 &＃61; E 意思是错误&＃xff08;error&＃xff09;&＃xff1b;

描述 &＃61; READREGDB 是对错误的描述&＃xff08;意思是不能读注册表数据库&＃xff09;。 S_OK: 没有功能码——通用&＃xff08;generic&＃xff09;

HRESULT&＃xff1b;

程度&＃61;S&＃xff1b;表示成功&＃xff08;success&＃xff09;&＃xff1b;

OK 是状态描述表示一切都好&＃xff08;everything&＃39;&＃39;s OK&＃xff09;。









&＃xff08;待续&＃xff09;