IOleLink：：Update 方法 (oleidl.h)

项目
03/13/2024

汇报链接对象的复合文档的缓存数据。这涉及到绑定到链接源（如果尚未绑定）。

语法

HRESULT Update(
  [in] IBindCtx *pbc
);

参数

[in] pbc

指向绑定上下文中要用于绑定链接源的 IBindCtx 接口的指针。此参数可以为 NULL。绑定上下文缓存绑定过程中绑定的对象，包含应用于使用绑定上下文的所有操作的参数，并提供绑定实现应检索有关其环境的信息的方法。有关详细信息，请参阅 IBindCtx。

返回值

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

返回代码	说明
CACHE_E_NOCACHE_UPDATE	绑定操作正常工作，但未更新缓存。
CACHE_S_SOMECACHES_NOTUPDATED	绑定操作正常工作，但并非所有缓存都已更新。
OLE_E_CANT_BINDTOSOURCE	无法绑定到链接源。

注解

调用方备注

如果最终用户更新链接对象的缓存数据，容器应用程序应调用 Update 。

最终用户可以通过选择“链接”对话框中的“立即更新”按钮来更新链接对象的缓存数据。如果使用 OleUIEditLinks 函数显示 “链接 ”对话框，则必须实现 IOleUILinkContainer 接口。当最终用户选择“立即更新”按钮时，对话框将调用 IOleUILinkContainer：：UpdateLink 的实现。该方法的实现可以调用 Update。

容器应用程序还可以调用 Update 来更新链接对象，因为该方法在对链接对象调用 Update 时会调用它。

此方法同时更新自动链接和手动链接。对于手动链接，调用 Update 或 Update 是更新缓存的唯一方法。有关自动链接和手动链接的详细信息，请参阅 IOleLink：：SetUpdateOptions。

有关实现的说明

如果 bc 为非 NULL，则链接对象的 Update 实现调用 IBindCtx：：RegisterObjectBound 来注册绑定链接源。这可确保链接源在释放绑定上下文之前保持运行状态。

如果链接源无法绑定，则当前缓存保持不变。

要求

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