8. COM编程——CoCreateInstance创建COM对象

函数功能
用指定的类标识符创建一个Com对象
创建组件的最简单的方法是使用CoCreateInstance函数。

函数原型

STDAPI CoCreateInstance(
REFCLSID rclsid, //创建的Com对象的类标识符(CLSID)
LPUNKNOWN pUnkOuter, //指向接口IUnknown的指针
DWORD dwClsContext, //运行可执行代码的上下文
REFIID riid, //创建的Com对象的接口标识符
LPVOID * ppv //用来接收指向Com对象接口地址的指针变量
);

函数参数
rclsid
[in] 用来唯一标识一个对象的CLSID(128位),需要用它来创建指定对象。
pUnkOuter
[in] 如果为NULL, 表明此对象不是聚合式对象一部分。如果不是NULL, 则指针指向一个聚合式对象的IUnknown接口。
dwClsContext
[in] 组件类别. 可使用CLSCTX枚举器中预定义的值。可选值：

相关的组合值:

riid
[in] 引用接口标识符,用来与对象通信。
ppv
[out] 用来接收指向接口地址的指针变量。如果函数调用成功,*ppv包括请求的接口指针。

返回值
S_OK：指定的Com对象实例被成功创建。
REGDB_E_CLASSNOTREG：指定的类没有在注册表中注册. 也可能是指定的dwClsContext没有注册或注册表中的服务器类型损坏
CLASS_E_NOAGGREGATION：这个类不能创建为聚合型。
E_NOINTERFACE：指定的类没有实现请求的接口, 或者是IUnknown接口没有暴露请求的接口.