Метод IOleLink::GetSourceMoniker (oleidl.h)
Извлекает моникер, определяющий источник ссылки связанного объекта.
Синтаксис
HRESULT GetSourceMoniker(
[out] IMoniker **ppmk
);
Параметры
[out] ppmk
Адрес переменной указателя IMoniker , получающей указатель интерфейса на абсолютный моникер, идентифицирующий источник ссылки. При успешном выполнении реализация должна вызывать AddRef для ppmk; вызов Release лежит на вызывающем объекте. При возникновении ошибки реализация должна задать ppmk значение NULL.
Возвращаемое значение
Этот метод возвращает значение S_OK при успешном завершении. Другие возможные возвращаемые значения включают следующее.
| Код возврата | Описание |
|---|---|
|
Моникер недоступен. |
Комментарии
Примечания к вызывающим абонентам
Приложение-контейнер может вызывать 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 |