Метод IOleObject::Unadvise (oleidl.h)

Статья
08/25/2023

Удаляет ранее установленное консультативное подключение.

Синтаксис

HRESULT Unadvise(
  [in] DWORD dwConnection
);

Параметры

[in] dwConnection

Содержит токен ненулевого значения, который ранее был возвращен из IOleObject::Advise с помощью параметра pdwConnection .

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

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

Код возврата	Описание
E_FAIL	Операция не удалась.
OLE_E_NOCONNECTION	DwConnection не представляет допустимое подключение со сведениями.

Обычно контейнеры вызывают IOleObject::Unadvise при завершении работы или при удалении объекта. В некоторых случаях контейнеры могут вызывать этот метод для объектов, которые выполняются, но в настоящее время не отображаются, чтобы снизить затраты на поддержание нескольких консультативных подключений. Самый простой способ реализовать этот метод — делегировать вызов IOleObject::Unadvise.

Требования


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

См. также раздел

IOleAdviseHolder::Unadvise

IOleObject

IOleObject::Advise

IOleObject::EnumAdvise

Поделиться через