COM学习（初学者必看）

逍遥公子

创建COM对象

为了创建COM对象并从这个对象获得接口，必须调用COM库的API函数，CoCreateInstance()。其原型如下：
HRESULT CoCreateInstance ( REFCLSID rclsid, LPUNKNOWN pUnkOuter, DWORD dwClsContext, REFIID riid, LPVOID* ppv );

rclsid：coclass的CLSID
pUnkOuter：这个参数只用于COM对象的聚合，利用它向现有的coclass添加新方法。参数值为null表示不使用聚合。
dwClsContext：表示所使用COM服务器的种类。

当你调用CoCreateInstance()时，它负责在注册表中查找COM服务器的位置，将服务器加载到内存，并创建你所请求的coclass实例。

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



删除COM对象

前面说过，你不用释放COM对象，只要告诉它们你已经用完对象。IUnknown是每一个COM对象必须实现的接口，它有一个方法，Release()。调用这个方法通知COM对象你不再需要对象。一旦调用了这个方法之后，就不能再次使用这个接口，因为这个COM对象可能从此就从内存中消失了。
　　如果你的应用程序使用许多不同的COM对象，因此在用完某个接口后调用Release()就显得非常重要。如果你不释放接口，这个COM对象（包含代码的DLLs）将保留在内存中，这会增加不必要的开销。如果你的应用程序要长时间运行，就应该在应用程序处于空闲期间调用CoFreeUnusedLibraries() API。这个API将卸载任何没有明显引用的COM服务器，因此这也降低了应用程序使用的内存开销。
继续用上面的例子来说明如何使用Release()：


if(SUCCEEDED(hr))  
{  
    // 用pISL调用方法  
    // 通知COM 对象不再使用它  
    pISL->Release();  
}



基本接口——IUnknown

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

IUnknown 有三个方法:

AddRef() —— 通知COM对象增加它的引用计数。如果你进行了一次接口指针的拷贝，就必须调用一次这个方法，并且原始的值和拷贝的值两者都要用到。
Release() —— 通知COM对象减少它的引用计数。参见前面的Release()示例代码段；
QueryInterface() —— 从COM对象请求一个接口指针。当coclass实现一个以上的接口时，就要用到这个方法；
前面已经看到了Release()的使用，但如何使用QueryInterface()呢?当你用CoCreateInstance()创建对象的时候，你得到一个返回的接口指针。如果这个COM对象实现一个以上的接口（不包括IUnknown），你就必须用QueryInterface()方法来获得任何你需要的附加的接口指针。QueryInterface()的原型如下：

HRESULT 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**) &pIPF );

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

仔细做好串处理

　　这一部分将花点时间来讨论如何在COM代码中处理串。如果你熟悉Unicode 和ANSI，并知道如何对它们进行转换的话，你就可以跳过这一部分，否则还是读一下这一部分的内容。
　　不管什么时候，只要COM方法返回一个串，这个串都是Unicode串（这里指的是写入COM规范的所有方法）。Unicode是一种字符编码集，类似ASCII，但用两个字节表示一个字符。如果你想更好地控制或操作串的话，应该将它转换成TCHAR类型串。
　　TCHAR和以_t开头的函数（如_tcscpy()）被设计用来让你用相同的源代码处理Unicode和ANSI串。在大多数情况下编写的代码都是用来处理ANSI串和ANSI WindowsAPIs，所以在下文中，除非另外说明，我所说的字符/串都是指TCHAR类型。你应该熟练掌握TCHAR类型，尤其是当你阅读其他人写的有关代码时，要特别注意TCHAR类型。
　　当你从某个COM方法返回得到一个Unicode串时，可以用下列几种方法之一将它转换成char类型串：

调用 WideCharToMultiByte() API；
调用CRT 函数wcstombs()；
使用CString 构造器或赋值操作(仅用于MFC )；
使用ATL 串转换宏；
WideCharToMultiByte() 你可以用WideCharToMultiByte()将一个Unicode串转换成一个ANSI串。此函数的原型如下：

int WideCharToMultiByte ( UINT CodePage, DWORD dwFlags, LPCWSTR lpWideCharStr, int cchWideChar, LPSTR lpMultiByteStr, int cbMultiByte, LPCSTR lpDefaultChar, LPBOOL lpUsedDefaultChar );以下是参数解释：

CodePage：Unicode字符转换成的代码页。你可以传递CP_ACP来使用当前的ANSI代码页。代码页是256个字符集。字符0——127与ANSI编码一样。字符128——255与ANSI字符不同，它可以包含图形字符或者读音符号。每一种语言或地区都有其自己的代码页，所以使用正确的代码页对于正确地显示重音字符很重要。
dwFlags：dwFlags 确定Windows如何处理“复合” Unicode字符，它是一种后面带读音符号的字符。如è就是一个复合字符。如果这些字符在CodePage参数指定的代码页中，不会出什么事。否则，Windows必须对之进行转换。
传递WC_COMPOSITECHECK使得这个API检查非映射复合字符。
传递WC_SEPCHARS使得Windows将字符分为两段，即字符加读音，如e`。
传递WC_DISCARDNS使得Windows丢弃读音符号。
传递WC_DEFAULTCHAR使得Windows用lpDefaultChar参数中说明的缺省字符替代复合字符。
缺省行为是WC_SEPCHARS。
lpWideCharStr 要转换的Unicode串。
cchWideChar lpWideCharStr在Unicode 字符中的长度。通常传递-1，表示这个串是以0x00结尾。
lpMultiByteStr 接受转换的串的字符缓冲 cbMultiByte lpMultiByteStr的字节大小。
lpDefaultChar 可选——当dwFlags包含WC_COMPOSITECHECK | WC_DEFAULTCHAR并且某个Unicode字符不能被映射到同等的ANSI串时所传递的一个单字符ANSI串，包含被插入的“缺省”字符。可以传递NULL，让API使用系统缺省字符（一种写法是一个问号）。
lpUsedDefaultChar 可选——指向BOOL类型的一个指针，设置它来表示是否缺省字符曾被插入ANSI串。可以传递NULL来忽略这个参数。
// 假设已经有了一个Unicode 串 wszSomeString...  
char szANSIString [MAX_PATH];  
WideCharToMultiByte ( CP_ACP, // ANSI 代码页  
                      WC_COMPOSITECHECK, // 检查重音字符  
                      wszSomeString, // 原Unicode 串  
                      -1, // -1 意思是串以0x00结尾  
                      szANSIString, // 目的char字符串  
                      sizeof(szANSIString), // 缓冲大小  
                      NULL, // 肥缺省字符串  
                      NULL ); // 忽略这个参数


调用这个函数后，szANSIString将包含Unicode串的ANSI版本。调用这个函数后，szANSIString将包含Unicode串的ANSI版本。

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

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

以下是参数解释：

mbstr：接受结果ANSI串的字符（char）缓冲。

wcstr：要转换的Unicode串。

count：mbstr参数所指的缓冲大小。

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

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

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

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

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

使用单接口COM对象

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

初始化COM库。 （Initialize）；
创建一个与活动桌面交互的COM对象，并取得IActiveDesktop接口；
调用COM对象的GetWallpaper()方法；
如果GetWallpaper()成功，则输出/显示墙纸文件名；
释放接口（Release()）；
收回COM库（Uninitialize）；
WCHAR wszWallpaper [MAX_PATH];  
CString strPath;  
HRESULT hr;  
IActiveDesktop* pIAD; // 1. 初始化COM库（让Windows加载DLLs）。通常是在程序的InitInstance()中调用  
// CoInitialize ( NULL )或其它启动代码。MFC程序使用AfxOleInit()。  
CoInitialize ( NULL ); // 2. 使用外壳提供的活动桌面组件对象类创建COM对象。  
// 第四个参数通知COM需要什么接口(这里是IActiveDesktop).  
hr = CoCreateInstance ( CLSID_ActiveDesktop, NULL, CLSCTX_INPROC_SERVER, IID_IActiveDesktop, (void**) &pIAD );  
if ( SUCCEEDED(hr) )  
{  
    // 3. 如果COM对象被创建成功，则调用这个对象的GetWallpaper() 方法。  
    hr = pIAD->GetWallpaper ( wszWallpaper, MAX_PATH, 0 );  
    if ( SUCCEEDED(hr) )
    {
        // 4. 如果 GetWallpaper() 成功，则输出它返回的文件名字。  
        // 注意这里使用wcout 来显示Unicode 串wszWallpaper. wcout 是  
        // Unicode 专用，功能与cout.相同。  
        wcout << L"Wallpaper path is:/n " << wszWallpaper << endl << endl;  
    }
    else  
    {
        cout << _T("GetWallpaper() failed.") << endl << endl;  
    }  
    // 5. 释放接口。  
    pIAD->Release();
}  
else
{
    cout << _T("CoCreateInstance() failed.") << endl << endl;  
}
// 6. 收回COM库。MFC 程序不用这一步，它自动完成。
CoUninitialize();

使用多接口的COM对象

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

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

处理HRESULT

　　这一部分准备用SUCCEEDED 和 FAILED宏进行一些简单的出错处理。主要是深入研究从COM方法返回的HRESULT，以便达到完全理解和熟练应用。
　　HRESULT是个32位符号整数，其非负值表示成功，负值表示失败。HRESULT有三个域：程度位（表示成功或失败），功能码和状态码。功能码表示HRESULT来自什么组件或程序。微软给不同的组件多赋予功能码，如：COM、任务调度程序等都有功能码。功能码是个16位的值，仅此而已，没有其它内在含义；它在数字和意义之间是随意关联的；类似GetLastError()返回的值。
　　如果你在winerror.h头文件中查找错误代码，会看到许多按照[功能]_[程度]_[描述]命名规范列出的HRESULT值，由组件返回的通用的HRESULT（类似E_OUTOFMEMORY）在名字中没有功能码。如：

REGDB_E_READREGDB：
功能码 = REGDB, 指“注册表数据库（registry database）”；
程度 = E 意思是错误（error）；
描述 = READREGDB 是对错误的描述（意思是不能读注册表数据库）。 S_OK: 没有功能码——通用（generic）
HRESULT；
程度=S；表示成功（success）；
OK 是状态描述表示一切都好（everything''s OK）。

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



另外一种查找HRESULT描述的方法是在调试器中。假设有一个HRESULT变量是hres。在Watch窗口的左边框中输入“hres,hr”，表示想要看的值，“hr”便会通知VC显示HRESULT所描述的值。