OleCreateDefaultHandler 函数 (ole2.h)

  • 项目

创建默认嵌入处理程序的新实例。 此实例已初始化，以便在嵌入对象进入运行状态时创建本地服务器。

语法

HRESULT OleCreateDefaultHandler(
  [in]  REFCLSID  clsid,
  [in]  LPUNKNOWN pUnkOuter,
  [in]  REFIID    riid,
  [out] LPVOID    *lplpObj
);

参数

[in] clsid

CLSID 标识嵌入对象进入运行状态时要加载的 OLE 服务器。

[in] pUnkOuter

指向控制 IUnknown 接口（如果要聚合处理程序）的指针;如果未聚合，则为 NULL 。

[in] riid

对接口标识符的引用（通常IID_IOleObject），调用方将通过该标识符与处理程序进行通信。

[out] lplpObj

接收 riid 中请求的接口指针的指针变量的地址。 成功返回后，*ppvObj 在新创建的处理程序上包含请求的接口指针。

返回值

此函数在成功时返回 NOERROR，并支持标准返回值E_OUTOFMEMORY。

注解

OleCreateDefaultHandler 会创建默认嵌入处理程序的新实例，并进行了初始化，以便在嵌入对象进入运行状态时创建由 clsid 参数标识的本地服务器。 如果要编写处理程序并想要使用默认处理程序的服务，请调用 OleCreateDefaultHandler。 未注册对象创建调用中指定的 CLSID 时，OLE 也会在内部调用它。

如果给定的类没有特殊处理程序，则对 OleCreateDefaultHandler 的调用将产生与调用 CoCreateInstance 函数的结果相同，其中类上下文参数分配了值CLSCTX_INPROC_HANDLER。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 ole2.h
Library Ole32.lib
DLL Ole32.dll

另请参阅

CLSCTX

CoCreateInstance