IOleLink：：SetUpdateOptions 方法 (oleidl.h)

项目
03/01/2024

指定链接对象应更新其缓存数据的频率。

语法

HRESULT SetUpdateOptions(
  [in] DWORD dwUpdateOpt
);

参数

[in] dwUpdateOpt

指定链接对象应更新其缓存数据的频率。 dwUpdateOpt 的可能值取自枚举 OLEUPDATE。

返回值

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

返回代码	说明
E_INVALIDARG	提供的值无效。

注解

调用方备注

当最终用户更改链接对象的更新选项时，容器应用程序应调用 IOleLink：：SetUpdateOptions 。

最终用户使用“ 链接 ”对话框选择链接对象的更新选项。如果使用 OleUIEditLinks 函数显示此对话框，则必须实现 IOleUILinkContainer 接口。该对话框调用 IOleUILinkContainer：：SetLinkUpdateOptions 方法以指定最终用户选择的更新选项。此方法的实现应调用 IOleLink：：SetUpdateOptions 方法，以将所选选项传递给链接对象。

实施者说明

默认更新选项为OLEUDPATE_ALWAYS。链接对象的 IPersistStorage：：Save 实现将保存当前更新选项。

如果将 OLEUDPATE_ALWAYS 指定为更新选项，链接对象将在以下情况下更新链接的缓存：

当更新选项从手动更改为自动时，如果链接源正在运行。
每当链接对象绑定到链接源时。
每当链接源正在运行并且链接对象的 IOleObject：：Close、 IPersistStorage：：Save 或 IAdviseSink：：OnSave 实现都调用时。

对于手动和自动链接，每当容器应用程序调用 IOleObject：：Update 或 IOleLink：：Update 时，链接对象会更新缓存。

要求

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