通过

IOleUILinkContainerA：：UpdateLink 方法 (oledlg.h)

  • 项目

强制所选链接连接到其源并检索当前信息。

语法

HRESULT UpdateLink(
  [in] DWORD dwLink,
  [in] BOOL  fErrorMessage,
  [in] BOOL  fReserved
);

参数

[in] dwLink

单个链接的容器定义的唯一标识符。 容器可以使用指向链接容器站点的指针获取此值。

[in] fErrorMessage

确定调用方 (IOleUILinkContainer) 的实现者是否应在更新链接失败时显示错误消息。 “ 更新链接 ”对话框将此设置为 FALSE。 “ 对象属性 ”和“ 链接 ”对话框将其设置为 TRUE。

[in] fReserved

此参数为保留参数，必须设置为 FALSE。

返回值

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

返回代码 说明
E_ACCESSDENIED
 访问权限不足。
E_FAIL
 此操作失败。
E_INVALIDARG
 指定的标识符无效。
E_OUTOFMEMORY
 可用于此操作的内存不足。

注解

调用方备注

如果用户明确按下按钮以更新链接，即按下链接的“立即更新”按钮，请在 fErrorMessage 设置为 TRUE 的情况下调用此方法。 如果容器永远不会显示错误消息，即正在执行大量操作，并且稍后应将错误传播回用户，则使用 FALSE 调用它，就像 更新链接 进度表一样。 不要为每个失败提供一条消息（假设存在故障），而是在操作结束时为所有失败提供一条消息。

实施者说明

对于 OLE 链接，请调用 IOleObject：：Update。

要求

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

另请参阅

IOleObject：：Update

IOleUILinkContainer