IOleLink：：SetSourceDisplayName 方法 (oleidl.h)

项目
03/04/2024

设置链接源的显示名称。

语法

HRESULT SetSourceDisplayName(
  [in] LPCOLESTR pszStatusText
);

参数

[in] pszStatusText

指向新链接源的显示名称的指针。此参数不能为 NULL。

返回值

此方法在成功时返回S_OK。

也可以在此处返回 MkParseDisplayName 中的值。

注解

给调用方的说明

当最终用户更改链接源或中断链接时，容器应用程序可以调用 IOleLink：：SetSourceDisplayName 。请注意，这需要链接对象从显示名称中创建名字对象。如果希望自己将显示名称解析为名字对象，容器可以调用 IOleLink：：SetSourceMoniker ，而不是 IOleLink：：SetSourceDisplayName。

如果使用 OleUIEditLinks 函数显示 “链接 ”对话框，则必须实现 IOleUILinkContainer 接口。该对话框调用 IOleUILinkContainer：：SetLinkSource 和 IOleUILinkContainer：：CancelLink 的实现。这些方法的实现可以调用 IOleLink：：SetSourceDisplayName。

如果容器应用程序立即要绑定到新指定的链接源，则应改为调用 MkParseDisplayName 和 IOleLink：：SetSourceMoniker ，然后使用分析操作中的绑定上下文调用 IOleLink：：BindToSource 。通过重用绑定上下文，可以避免冗余加载否则可能发生的对象。

实施者说明

IOleLink：：SetSourceDisplayName 的协定未指定链接对象何时将显示名称解析为名字对象。分析可以在 IOleLink：：SetSourceDisplayName 返回之前进行，或者链接对象可以存储显示名称，并仅在需要绑定到链接源时才对其进行分析。请注意，分析显示名称可能是一项成本高昂的操作，因为它可能需要绑定到链接源。提供的 IOleLink：：SetSourceDisplayName 实现将分析显示名称，然后释放分析操作中使用的绑定上下文。这可能会导致运行并停止链接源服务器。

如果链接对象绑定到当前链接源， 则 IOleLink：：SetSourceDisplayName 的实现会中断连接。

有关链接对象如何存储并将名字对象用于链接源的详细信息，请参阅 IOleLink：：SetSourceMoniker。

要求

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