OleCreateLink 函数 (ole2.h)

  • 项目

创建 OLE 复合文档链接对象。

语法

HRESULT OleCreateLink(
  [in]  LPMONIKER       pmkLinkSrc,
  [in]  REFIID          riid,
  [in]  DWORD           renderopt,
  [in]  LPFORMATETC     lpFormatEtc,
  [in]  LPOLECLIENTSITE pClientSite,
  [in]  LPSTORAGE       pStg,
  [out] LPVOID          *ppvObj
);

parameters

[in] pmkLinkSrc

指向名字对象上 IMoniker 接口的指针，该接口可用于查找链接对象的源。

[in] riid

调用方稍后用来与新对象通信的接口标识符的引用 (通常IID_IOleObject，在 OLE 标头中定义为 IOleObject) 的接口标识符。

[in] renderopt

指定枚举 OLERENDER 中的值，该值指示新创建的对象将具有本地缓存的绘图或数据检索功能。 下面的“备注”部分介绍了其他注意事项。

[in] lpFormatEtc

指向枚举 OLERENDER 中的值的指针，该值指示新创建的对象要具有的本地缓存绘图或数据检索功能。 所选 的 OLERENDER 值会影响 lpFormatEtc 参数的可能值。

[in] pClientSite

指向 IOleClientSite 实例的指针，IOleClientSite 是对象通过该接口从其容器请求服务的主接口。 此参数可以为 NULL。

[in] pStg

指向存储对象上的 IStorage 接口的指针。 此参数不能为 NULL。

[out] ppvObj

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

返回值

此函数在成功时返回S_OK。 其他可能的值包括以下内容。

返回代码 说明
OLE_E_CANT_BINDTOSOURCE
 无法绑定到源。

注解

调用 OleCreateLink 以允许容器创建指向对象的链接。

要求

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

请参阅

IOleClientSite：：GetMoniker

IOleObject：：SetMoniker