IOleLink：：SetSourceDisplayName 方法 (oleidl.h)
设置链接源的显示名称。
语法
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 |