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。 其他可能的值包括以下内容。
返回代码 | 说明 |
---|---|
|
文件名无效。 |
|
无法绑定到源。 |
注解
OleCreateLinkToFile 函数不同于 OleCreateLink 函数,因为它可以创建指向不知道 OLE 的文件以及使用 Windows Packager 的文件的链接。
要求
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | ole2.h |
Library | Ole32.lib |
DLL | Ole32.dll |