com学习记录(一)——基本概念

com学习记录(一)——基本概念
com学习记录(二)——使用vs2019完成windows下的com组件编程
com学习记录(三)——在Linux环境下完成com组件编程
com学习记录(四)——在Linux环境下完成com组件编程分离服务端（动态库）客户端（可执行程序）

​ COM即组件对象模型（Component Object Model）
​
​ COM是一种跨应用和语言共享二进制代码的方法
​
​ COM通过定义二进制标准解决了这些问题，即COM明确指出二进制模块（DLLs和EXEs）必须被编译成与指定的结构匹配。这个标准也确切规定了在内存中如何组织COM对象。COM定义的二进制标准还必须独立于任何编程语言（如C++中的命名修饰）。一旦满足了这些条件，就可以轻松地从任何编程语言中存取这些模块。由编译器负责所产生的二进制代码与标准兼容。这样使后来的人就能更容易地使用这些二进制代码。
​
​ 在内存中，COM对象的这种标准形式在C++虚函数中偶尔用到，所以这就是为什么许多COM代码使用C++的原因。但是记住，编写模块所用的语言是无关的，因为结果二进制代码为所有语言可用。
​
​ 此外，COM不是Win32特有的。从理论上讲，它可以被移植到Unix或其它操作系统。
​
​ COM服务器是包含了一个或多个coclass的二进制（DLL或EXE）。
​
​ GUID（谐音为“fluid”，意思是全球唯一标示符——globally unique identifier）是个128位的数字。它是一种独立于COM编程语言的标示方法。每一个接口和coclass有一个GUID。因为每一个GUID都是全球唯一的，所以避免了名字冲突（只要你用COM API创建它们）。有时你还会碰到另一个术语UUID（意思也是全球唯一标示符——universally unique identifier）。UUIDs和GUIDs在实际使用时的用途是一样的。 类ID或者CLSID是命名coclass的GUID。接口ID或者IID是命名接口的GUID。

​

• 创建一个新对象：

  C++中，用new操作符，或者在栈中创建对象。

  COM中，调用COM库中的API。

• 删除对象*

  C++中，用delete操作符，或将栈对象踢出。

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

• 创建COM对象

  为了创建COM对象并从这个对象获得接口，必须调用COM库的API函数，CoCreateInstance()。

其原型如下：

HRESULTCoCreateInstance
(
    REFCLSID 	rclsid,
    LPUNKNOWN 	pUnkOuter,
    DWORD 		dwClsContext,
    REFIID 		riid,
    LPVOID 		*ppv
);
// rclsid：coclass的CLSID，例如，可以传递CLSID_ShellLink创建一个COM对象来建立快捷方式。
	
// pUnkOuter：这个参数只用于COM对象的聚合，利用它向现有的coclass添加新方法。参数值为null表示不使用聚合。
	
// dwClsContext：表示所使用COM服务器的种类。 本文使用的是最简单的COM服务器，一个进程内（in-process）DLL， 所以传递的参数值为CLSCTX_INPROC_SERVER。注意这里不要随意使用CLSCTX_ALL（在ATL中，它是个缺省值， 因为在没有安装DCOM的Windows95系统上会导致失败。
	
// riid：请求接口的IID。例如，可以传递IID_IShellLink获得IShellLink接口指针。
	
// ppv：接口指针的地址。

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

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

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

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

• 释放

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

基本接口

​ 每一个COM接口都派生于IUnknown，每个COM对象都实现IUnknown

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

​ 当你用CoCreateInstance()创建对象的时候，你得到一个返回的接口指针。如果这个COM对象实现一个以上的接口（不包括IUnknown），你就必须用QueryInterface()方法来获得任何你需要的附加的接口指针。
​ QueryInterface()的原型：HRESULT IUnknown::QueryInterface ( REFIID iid, void** ppv );

• iid：所请求的接口的IID。
• ppv：接口指针的地址，QueryInterface()通过这个参数在成功时返回这个接口。

HRESULT hr;

IPersistFile *pIPF;

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

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

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

​ intWideCharToMultiByte(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 l pWideCharStr: 在Unicode 字符中的长度。通常传递-1，表示这个串是以0x00结尾。

• lpMultiByteStr: 接受转换的串的字符缓冲

• cbMultiByte: lpMultiByteStr的字节大小。

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

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

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

​ wcstombs()这个CRT函数是WideCharToMultiByte()的简化版，但它总结了WideCharToMultiByte()的调用，所以最终结果是一样的。

size_t wcstombs(char *mbstr, constwchar_t *wcstr, size_t count);
// mbstr：接受结果ANSI串的字符（char）缓冲。
// wcstr：要转换的Unicode串。
// count：mbstr参数所指的缓冲大小。

单接口COM对象

初始化COM库。 （Initialize）；

创建一个与活动桌面交互的COM对象，并取得IActiveDesktop接口；

调用COM对象的GetWallpaper()方法；

如果GetWallpaper()成功，则输出/显示墙纸文件名；

释放接口（Release()）；

收回COM库（Uninitialize）；

WCHARwszWallpaper[MAX_PATH];
CStringstrPath;
HRESULThr;
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"Wallpaperpathis:\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对象QueryInterface()函数

初始化 COM 库；

创建一个用于建立快捷方式的COM 对象并取得IShellLink 接口；

调用IShellLink 接口的SetPath()方法；

调用对象的QueryInterface()函数并取得IPersistFile接口；

调用IPersistFile 接口的Save()方法；

释放接口；

收回COM库；

CString sWallpaper = wszWallpaper;
//将墙纸路径转换为ANSII
ShellLink *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

​ HRESULT是个32位符号整数，其非负值表示成功，负值表示失败。
​ HRESULT有三个域：程度位（表示成功或失败），功能码和状态码。
​ 功能码表示HRESULT来自什么组件或程序。是个16位的值，仅此而已，没有其它内在含义
winerror.h头文件中查找错误代码，会看到许多按照[功能][程度][描述]命名规范列出的HRESULT值,由组件返回的通用的HRESULT（类似E_OUTOFMEMORY）在名字中没有功能码。

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