OleCreateLinkToFile 函数 (ole2.h)

创建链接到文件的对象。

语法

HRESULT OleCreateLinkToFile(
  [in]  LPCOLESTR       lpszFileName,
  [in]  REFIID          riid,
  [in]  DWORD           renderopt,
  [in]  LPFORMATETC     lpFormatEtc,
  [in]  LPOLECLIENTSITE pClientSite,
  [in]  LPSTORAGE       pStg,
  [out] LPVOID          *ppvObj
);

parameters

[in] lpszFileName

指向命名要链接到的源文件的字符串的指针。

[in] riid

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

[in] renderopt

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

[in] lpFormatEtc

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

[in] pClientSite

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

[in] pStg

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

[out] ppvObj

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

返回值

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

返回代码 说明
STG_E_FILENOTFOUND
文件名无效。
OLE_E_CANT_BINDTOSOURCE
无法绑定到源。

注解

OleCreateLinkToFile 函数不同于 OleCreateLink 函数,因为它可以创建指向不知道 OLE 的文件以及使用 Windows Packager 的文件的链接。

要求

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

请参阅

OleCreateLink