CocreateInstance：一个全能开发者不可或缺的API

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，并且需要处理错误和在多线程环境中使用时需要注意多个细节。