IOleUILinkContainerA：：GetLinkSource 方法 (oledlg.h)

项目
03/01/2024

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

语法

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

参数

[in] dwLink

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

[out, optional] lplpszDisplayName

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

[out] lplenFileName

指向 lpszDisplayName 字符串的前导文件名部分长度的指针。如果链接源未存储在文件中，则 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