IOleUILinkContainerW：：GetLinkSource 方法 (oledlg.h)

项目
08/25/2023

检索可在“ 链接 ”对话框中显示的链接的相关信息。

语法

HRESULT GetLinkSource(
  [in]            DWORD  dwLink,
  [out, optional] LPWSTR *lplpszDisplayName,
  [out]           ULONG  *lplenFileName,
  [out, optional] LPWSTR *lplpszFullLinkType,
  [out, optional] LPWSTR *lplpszShortLinkType,
  [out]           BOOL   *lpfSourceAvailable,
  [out]           BOOL   *lpfIsSelected
);

parameters

[in] dwLink

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

[out, optional] lplpszDisplayName

接收指向链接源的完整显示名称字符串的指针变量的地址。 “ 链接 ”对话框将释放此字符串。

[out] lplenFileName

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

[out, optional] lplpszFullLinkType

接收指向“ 链接 ”对话框底部显示的完整链接类型字符串的指针变量的地址。调用方分配此字符串。 “ 链接 ”对话框将释放此字符串。对于 OLE 链接，这应该是完整的用户类型名称。使用 IOleObject：：GetUserType，为 dwFormOfType 指定USERCLASSTYPE_FULL。

[out, optional] lplpszShortLinkType

指针变量的地址，该指针变量接收指向“ 链接 ”对话框的列表框中显示的短链接类型字符串的指针。调用方分配此字符串。 “ 链接 ”对话框将释放此字符串。对于 OLE 链接，这应该是短用户类型名称。使用 IOleObject：：GetUserType，为 dwFormOfType 指定USERCLASSTYPE_SHORT。

[out] lpfSourceAvailable

如果已知链接不可用，则返回 FALSE 的指针，因为链接指向某个已知但不可用的文档。对于这种情况，某些选项（如 “立即更新”）处于禁用状态， (用户界面) 灰显。

[out] lpfIsSelected

指向变量的指针，该变量指示“ 编辑链接 ”对话框应在对话框的多选列表框中选择此链接的条目。 OleUIEditLinks 至少为要放置在链接列表中的每个项调用此方法一次。如果它们均未返回 TRUE，则在首次显示对话框时，不会选择其中任何一个。如果它们全部返回 TRUE，则将显示所有值。也就是说，如果此链接当前是基础文档中所选内容的一部分，则返回 TRUE ;否则返回 FALSE 。在基础文档中选择的任何链接都在对话框中被选中;这样，用户可以选择一组链接，并使用对话框来更新它们，或者同时更改其源 () 。

返回值

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

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

注解

调用方备注

从“ 更改源 ”对话框返回后，在对话框初始化期间调用此方法。

要求


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