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

Статья
08/25/2023

Извлекает моникер, определяющий источник ссылки связанного объекта.

Синтаксис

HRESULT GetSourceMoniker(
  [out] IMoniker **ppmk
);

Параметры

[out] ppmk

Адрес переменной указателя IMoniker , получающей указатель интерфейса на абсолютный моникер, идентифицирующий источник ссылки. При успешном выполнении реализация должна вызывать AddRef для ppmk; вызов Release лежит на вызывающем объекте. При возникновении ошибки реализация должна задать ppmk значение NULL.

Возвращаемое значение

Этот метод возвращает значение S_OK при успешном завершении. Другие возможные возвращаемые значения включают следующее.

Код возврата	Описание
MK_E_UNAVAILABLE	Моникер недоступен.

Приложение-контейнер может вызывать IOleLink::GetSourceMoniker для отображения текущего источника ссылки в диалоговом окне Ссылки . Обратите внимание, что для этого контейнер должен использовать метод IMoniker::GetDisplayName для получения отображаемого имени моникера. Если вы хотите получить отображаемое имя напрямую, контейнер может вызвать IOleLink::GetSourceDisplayName вместо IOleLink::GetSourceMoniker.

Если для отображения диалогового окна Ссылки используется функция OleUIEditLinks, необходимо реализовать интерфейс IOleUILinkContainer. Диалоговое окно вызывает реализации IOleUILinkContainer::GetLinkSource , чтобы получить строку, которую он должен отобразить. Реализация этого метода может вызывать IOleLink::GetSourceMoniker.

Примечания для разработчиков

Связанный объект хранит как абсолютный, так и относительный моникер для источника ссылки. Если относительный моникер не равен NULL и моникер доступен для составного документа, IOleLink::GetSourceMoniker возвращает моникер, созданный путем создания относительного моникера в конце моникера составного документа. В противном случае возвращается абсолютный моникер или, если возникает ошибка, ЗНАЧЕНИЕ NULL.

Контейнер задает абсолютный моникер при вызове одной из функций OleCreateLink для создания ссылки. Приложение может вызывать IOleLink::GetSourceMoniker или IOleLink::GetSourceDisplayName , чтобы изменить абсолютный моникер. Кроме того, связанный объект автоматически обновляет моникеры при успешной привязке к источнику ссылки или при привязке к источнику ссылки и получении уведомления о переименовании с помощью метода IAdviseSink::OnRename .

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	oleidl.h