• 1.摘要
  • 2.基本信息
  • 3.函数功能描述
  • 4.实例
  • 5.要求

CoCreateInstance

CoCreateInstance,函数名。用指定的类标识符创建一个Com对象,用指定的类标识符创建一个未初始化的对象。当在本机中只创建一个对象时,可以调用CoCreateInstance;在远程系统中创建一个对象时,可以调用CoCreateInstanceEx;创建多个同一CLSID的对象时, 可以参考CoGetClassObject函数。

基本信息

  • 中文名

    CoCreateInstance

  • 归类

    windows系统API函数

  • 功能描述

    创建一个Com对象

  • 函数原形

    STDAPI 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枚举器中预定义的值.

可选取值如下:

CLSCTX_INPROC_SERVER

创建在同一进程中运行的组件。为能够同一进程中运行,组件必须是在DLL中实现的。

CLSCTX_INPROC_HANDLER

创建进程中处理器。一个进程中处理器实际上是一个只实现了某个组建一部分的进程中组件。该组件的其他部分将由本地或远程服务器上的某个进程外组件实现。

CLSCTX_LOCAL_SERVER

创建一个在同一机器上的另外一个进程中运行的组件。本地服务器是由exe实现的。

CLSCTX_REMOTE_SERVER

创建一个在远程机器上运行的组件。此标志需要分布式COM正常工作。

相关的组合值: