com技术内幕--读书笔记（6）

第6章

在前五章，作者将细节问题隐藏起来。本章主要将讨论COM的细节问题--HRESULT，GUID，注册表，最后介绍了COM库中一些函数。

HRESULT：

是QueryInterface的返回值。在设计组件的时候，可以用它来返回争取及错误代码。

HRESULT值实际上是一个可分成3个域的32位值，

HRESULT的低16位（0-15位）是函数返回值；16到30bit位返回的是设备值（操作系统代码），可以使用HRESULT_FACILITY宏来查看HRESULT值的设备；31bit返回严重级别。

WIN32的API中的FormatMessage函数可以将HRESULT错误信息打印出来，判断成功和失败使用SUCCEEDED和FAILED宏。

用户还可以自定义跟接口相关的HRESULT返回值，其中设备值部分必须是FACILITY_ITF，使用MAKE_HRESULT宏。还有几条规则：

（1）不能使用0x0000到0x01FF范围内的值。这是COM定义的FACILITY_ITY保留值。

（2）不要传播FACILITY_ITY错误代码。

（3）尽可能使用通用的COM成功和失败代码。

（4）避免定义自己的HRESULT，可以在函数中使用一个输出参数。

HRESULT其实是一个LONG型的值。预定义的HRESULT值在WINERROR.H，打开该文件看了一下。第31bit是一个Severity - indicates success/fail 0 - Success
1 - Fail (COERROR)，SUCCEEDED和FAILED宏是根据这个bit来判断是成功还是失败。

GUID：

GUID可以用来标识组件和接口的ID。

前几章使用的IID是一个16字节（128bit）的GUID。GUID是Globally Unique Identifier的简称，在COM组件开发过程中主要是为了保证IID即接口ID的唯一性。Microsoft提供了两个生成GUID的程序，一个是UUIDGEN.EXE（命令行形式），一个是GUIDGEN.EXE（对话框形式）。

GUID的结构是

#ifndef GUID_DEFINED#define GUID_DEFINEDtypedef struct _GUID {          // size is 16    DWORD Data1;    WORD   Data2;    WORD   Data3;    BYTE  Data4[8];} GUID;#endif // !GUID_DEFINED

在OBJBASE.H文件中，定义了operator==操作符

__inline BOOL operator==(const GUID& guidOne, const GUID& guidOther){    return !memcmp(&guidOne,&guidOther,sizeof(GUID));}

GUID除了可以唯一的标识接口以外，还可以用来唯一标识组件，称为类标识符CLSID。在第六章将会用到COM库的CoCreateInstance函数就是使用CLSID来将要创建的组件。

IID的引用const IID &可以使用REFIID，CLSID是REFCLSID，GUID是REFGUID（都定义在OBJBASE.H文件中）。

Windows注册表

对于组件的使用者来说，怎样找到组件所在的文件，并且能够正确的调用它们，就要用到注册表，注册表中保存了组件所在的文件及其他信息。

CLSID在注册表中作为索引在注册表中发布包含它的DLL文件的名称，作为CoCreateInstance函数的传入参数，CoCreateInstance使用CLSID作为关键字在注册表中查找所需的文件名称。

注册表中是由许多元素组成的层次结构，每一个元素被称作一个关键字。每一个关键字可以包含一系列子关键字、一系列命名的值、一个未命名的值。

在此，我们关心CLSID和DLL文件的名称。

COM使用了注册表的一个分支HKEY_CLASSES_ROOT，在这个关键字下有一个CLSID的子关键字，在CLSID关键字下列有系统中安装的所有组件的CLSID，每一个CLSID关键字的缺省值是组件有意义的名称，子关键字InproServer32的缺省值是组件所在的DLL文件名称。如下图所示

HKEY_CLASSES_ROOT

注册表HKEY_CLASSES_ROOT关键字的开头，列出的是各种应用程序注册的文件扩展名。在扩展名之后，有许多其他的名字，大多数是ProgID，ProgID是给某个CLSID指定的容易记忆的名称，Visual Basic使用ProgID而不是CLSID来标识组件。还有AppID，此关键字下子关键字的作用是将某个APPID映射为某个远程服务器的名称，将在第10章讨论。组件类别，讲CATID（组件类别ID）映射为某个特定的组件类别。Interface，用于讲IID映射为某个接口的相关信息，用于在跨进程使用接口的情况，将在第10章讨论。TypeLib，保存接口成员函数使用的参数信息，将在第11章讨论。

ProgID

ProgID是为CLSID起的容易记忆的名字，只是没办法保证ProgID的唯一性。ProgID的命名约定<Program>.<Component>.<Version>，<Version>字段可以没有，ProgID的主要作用是获取相应的CLSID，ProgID关键字的缺省值是组件用户易记的名称，它下面有一个CLSID的子关键字，缺省值是组件的CLSID。<Version>字段没有的ProgID也被列在HKEY_CLASSES_ROOT下，除了CLSID子关键字，还有一个CurVer的子关键字，缺省值是组件当前版本的ProgID。如下图所示

注册表的其他细节

（1）CLSIDFromProgID和ProgIDFromCLSID，可以进行CLSID和ProgID之间的转换。

（2）组件注册----重要

写完了组件，怎样在注册表中对它进行注册呢，以方便使用者来调用它。

在包含组件的DLL中需要输出STDAPI DllRegisterServer()和STDAPI DllUnregisterServer()函数，其中STDAPI在OBJBASE.H中定义为extern "C" HRESULT __stdcall，使用regsvr32.exe来注册某个组件的过程，其实就是调用DllRegisterServer函数进行注册，在DllRegisterServer和DllUnregisterServer中实际上使用WIN32 API的注册表编辑函数RegCreateKeyEx，RegSetValueEx等来完成组件的注册或取消（使用Reg函数需要链接ADVAPID32.LIB导入库）。

（3）组件类别

组件类别实际上是一个接口集合，也是用GUID进行识别，只是被称作CATID。如果某个组件能够实现该组件类别的所有接口，它就可以是该组件类别的一个成员。组件的开发人员不需要自己完成将组件加入组件类别的注册工作，Windows系统的Component Category Manager会完成这个工作。

（4）OleView

Win32 SDK提供的OleView提供了查看组件的另外一种方式。

COM库函数

COM组件的使用者和创建者，都需要使用一些相同的操作，例如对使用者来说，用CLSID来调用组件的函数等等。这些都在COM库中实现，统一用户的调用方法。

COM库函数在OLE32.DLL中实现

（1）初始化

除了CoGetMalloc外，在使用COM库函数之前，必须调用CoInitialize函数来初始化，当不使用时，调用CoUninitialize函数。这两个函数的原型是HRESULT CoInitialize(void *reserved)和void CoUninitialize()，reserved参数必须为NULL。对于每个进程，COM库函数只需初始化一次。OLE是建立在COM库基础上的，当需要对类型库、剪贴板、拖放、ActiveX文档、自动化及ActiveX控件的支持时，需要调用OleInitialize及OleUninitialize函数。

（2）内存管理

任务内存分配器，考虑到了多线程同步的问题，可以再多线程应用程序中使用。

CoGetMalloc返回IMalloc接口，IMalloc接口的Alloc，Free函数来分配，释放内存。更方便的方式是使用void* CoTaskMemAlloc(ULONG cb //size in bytes)和void CoTaskMemFree(void* pv)。

（3）字符串转化成GUID

StringFromCLSID，StringFromIID，StringFromGUID2，CLSIDFromString，IIDFromString，可以完成字符串与GUID之间的转换。详细的用法，查看MSDN。