IOleUILinkContainerA：：SetLinkSource 方法 (oledlg.h)

  • 项目

更改链接的源。

语法

HRESULT SetLinkSource(
  [in]  DWORD dwLink,
  [in]  LPSTR lpszDisplayName,
  [in]  ULONG lenFileName,
  [out] ULONG *pchEaten,
  [in]  BOOL  fValidateSource
);

parameters

[in] dwLink

单个链接的容器定义的唯一标识符。 请参阅 IOleUILinkContainer：：GetNextLink。

[in] lpszDisplayName

指向要分析的新源字符串的指针。

[in] lenFileName

lpszDisplayName 字符串的前导文件名部分的长度。 如果链接源未存储在文件中，则 lenFileName 应为 0。 对于 OLE 链接，请调用 IOleLink：：GetSourceDisplayName。

[out] pchEaten

指向 在 lpszDisplayName 中成功分析的字符数的指针。

[in] fValidateSource

如果应验证名字对象，则为 TRUE;对于 OLE 链接，应调用 MkParseDisplayName。 如果不应验证名字对象，则为 FALSE。 如果可能，链接应接受未经验证的源，并将自身标记为不可用。

返回值

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

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

注解

调用方备注

从“ 更改源 ”对话框调用此方法， fValidateSource 最初设置为 TRUE。 可以直接或通过“链接”对话框调用“更改源”。 如果此对 IOleUILinkContainer：：SetLinkSource 的调用返回错误 (例如 ，MkParseDisplayName 失败，因为源) 不可用，则应显示“ 链接源无效 ”消息，并且应允许用户决定是否修复源。 如果用户选择修复源，则应将用户返回到“ 更改源 ”对话框，并突出显示输入字符串的无效部分。 如果用户选择不修复源，则应再次调用 IOleUILinkContainer：：SetLinkSource，并将 fValidateSource 设置为 FALSE，并且用户应返回到链接标记为“不可用”的“链接”对话框。

要求

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

请参阅

IOleUILinkContainer

MkParseDisplayName