IOleLink::Update 方法 (oleidl.h)
汇报链接对象的复合文档的缓存数据。 这涉及到绑定到链接源(如果尚未绑定)。
语法
HRESULT Update(
[in] IBindCtx *pbc
);
参数
[in] pbc
指向绑定上下文中要用于绑定链接源的 IBindCtx 接口的指针。 此参数可以为 NULL。 绑定上下文缓存绑定过程中绑定的对象,包含应用于使用绑定上下文的所有操作的参数,并提供绑定实现应检索有关其环境的信息的方法。 有关详细信息,请参阅 IBindCtx。
返回值
此方法在成功时返回S_OK。 其他可能的返回值包括以下内容。
返回代码 | 说明 |
---|---|
|
绑定操作正常工作,但未更新缓存。 |
|
绑定操作正常工作,但并非所有缓存都已更新。 |
|
无法绑定到链接源。 |
注解
调用方备注
如果最终用户更新链接对象的缓存数据,容器应用程序应调用 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 |