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

Статья
08/25/2023

Разрывает связь между связанным объектом и его источником связи.

Синтаксис

HRESULT UnbindSource();

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

Этот метод возвращает значение S_OK при успешном завершении.

UnbindSource обычно не вызывается напрямую. Если необходимо отключить подключение к источнику ссылки, контейнер обычно вызывает IOleObject::Close или IUnknown::Release; реализация этих методов связанного объекта вызывает UnbindSource. Реализация IAdviseSink::OnClose связанного объекта также вызывает UnbindSource.

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

Реализация UnbindSource связанного объекта не выполняет никаких действий, если источник ссылки в данный момент не привязан. Если источник ссылки привязан, UnbindSource вызывает реализации IOleObject::Unadvise и IDataObject::D Unadvise источника ссылок, чтобы удалить консультативные подключения к источнику ссылки. Метод UnbindSource также вызывает реализацию IOleContainer::LockContainer составного документа, чтобы разблокировать содержащий составной документ. Это отменяет блокировку контейнера и консультативных подключений, установленных в IOleLink::BindToSource. UnbindSource освобождает все указатели интерфейса связанного объекта на источник ссылки.

Требования

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