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 |