Метод IOleLink::SetSourceDisplayName (oleidl.h)

Статья
08/25/2023

Задает отображаемое имя источника ссылок.

Синтаксис

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
Header	oleidl.h