通过

IOleUILinkContainerW：：UpdateLink 方法 (oledlg.h)

  • 项目

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

语法

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

parameters

[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