CocreateInstance是一个关键的API，它可以创建一个指定的COM对象，并且可以关联到特定的接口。
一、简介
CocreateInstance是一个很常见的API，在开发Windows应用程序时经常用到的。使用CocreateInstance可以创建一个指定的COM对象，这个对象在系统中被描述成一个唯一的GUID。
一个COM对象需要支持多个接口，因此，开发者需要在创建COM对象时指定哪个接口将被使用。这些接口通过GUID来识别，因此，调用CocreateInstance时需要指定GUID。
关于COM对象和接口的概念，可以参考以下代码：
// 创建一个COM对象
CoCreateInstance(CLSID_MyObject, NULL, CLSCTX_INPROC_SERVER, IID_IMyInterface, (void**)&pMyObject);
// IMyInterface是COM对象实现的一个接口，定义如下：
interface IMyInterface
{
virtual void Function1() = 0;
virtual void Function2() = 0;
};
二、使用方式
使用CocreateInstance创建一个COM对象需要传入四个参数，分别是
- clsid：指定要创建的COM对象的CLSID
- pUnkOuter：预留参数，用于支持对象的聚合
- dwClsContext：指定COM服务器应该在哪个上下文中运行
- riid：要创建的COM对象所支持的接口的IID
注意，CocreateInstance创建对象时会调用CoGetClassObject API，这个API会查询在Windows注册表中查找指定CLSID的COM对象信息，然后会加载这个对象并返回指向它的指针。
代码演示：
// 创建一个COM对象
HRESULT hr = CoCreateInstance(CLSID_MyObject, NULL, CLSCTX_INPROC_SERVER, IID_IMyInterface, (void**)&pMyObject);
if (FAILED(hr))
{
// COM对象创建失败
}
三、实用技巧
1. 利用运行时类型库
运行时类型库（Type Library）是一个COM对象的元数据，包含它的类、接口、方法和属性等信息，可以通过OLE/COM Object Viewer等工具来查看。
在使用CocreateInstance时，如果你知道要创建的COM对象使用的是哪个接口，但是并不知道这个接口对应的IID是什么，可以借助运行时类型库来查找。
代码演示：
// 创建一个COM对象
HRESULT hr = CoCreateInstance(CLSID_MyObject, NULL, CLSCTX_INPROC_SERVER, __uuidof(IMyInterface), (void**)&pMyObject);
if (FAILED(hr))
{
// COM对象创建失败
}
2. 处理错误
CocreateInstance失败时会返回一个错误码，这时开发者需要根据错误码来确定错误的原因。
如果错误码是CLASS_E_CLASSNOTAVAILABLE，说明指定的CLSID没有被注册或者运行。如果错误码是CO_E_DLLNOTFOUND，说明指定的COM服务器不存在。
代码演示：
// 创建一个COM对象
HRESULT hr = CoCreateInstance(CLSID_MyObject, NULL, CLSCTX_INPROC_SERVER, IID_IMyInterface, (void**)&pMyObject);
if (FAILED(hr))
{
if (hr == CLASS_E_CLASSNOTAVAILABLE)
{
// 指定的CLSID没有被注册或者运行
}
if (hr == CO_E_DLLNOTFOUND)
{
// 指定的COM服务器不存在
}
// 其他错误处理
}
3. 在多线程环境中使用
在多线程环境中使用CocreateInstance需要注意几点：
- 在调用CocreateInstance之前需要先调用CoInitialize或CoInitializeEx来初始化COM库。
- 需要在创建对象之前先将线程设置为单线程模式，即调用CoMarshalInterThreadInterfaceInStream或者CoInitializeEx的COINIT_APARTMENTTHREADED标记。
- 需要在创建对象之后调用CoInitializeSecurity来设置安全上下文。
代码演示：
// 初始化COM库
CoInitialize(NULL);
// 设置线程为单线程模式
CoInitializeEx(NULL, COINIT_APARTMENTTHREADED);
// 创建COM对象
HRESULT hr = CoCreateInstance(CLSID_MyObject, NULL, CLSCTX_INPROC_SERVER, IID_IMyInterface, (void**)&pMyObject);
if (FAILED(hr))
{
// COM对象创建失败
}
// 设置安全上下文
CoInitializeSecurity(NULL, -1, NULL, NULL, RPC_C_AUTHN_LEVEL_DEFAULT,
RPC_C_IMP_LEVEL_IDENTIFY, NULL, EOAC_NONE, NULL);
// 释放COM对象
pMyObject->Release();
// 释放COM库
CoUninitialize();
四、总结
在Windows应用程序开发中，CocreateInstance是一个重要的API，可以用来创建指定的COM对象，并支持多个接口。在使用CocreateInstance时，需要指定CLSID和IID，并且需要处理错误和在多线程环境中使用时需要注意多个细节。
原创文章，作者：小蓝，如若转载，请注明出处：https://www.506064.com/n/199479.html
微信扫一扫 
支付宝扫一扫 