IOleLink::Update 方法 (oleidl.h)

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

语法

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 时会调用它。

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

有关实现的说明

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

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

要求

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

另请参阅

IBindCtx::RegisterObjectBound

IOleLink

IOleLink::SetUpdateOptions

IOleLink::Update

IOleUILinkContainer

OleUIEditLinks