Метод IExplorerBrowser::Advise (shobjidl_core.h)

Статья
08/26/2023

Инициирует соединение с IExplorerBrowser для обратных вызовов событий.

Синтаксис

HRESULT Advise(
  [in]  IExplorerBrowserEvents *psbe,
  [out] DWORD                  *pdwCookie
);

Параметры

[in] psbe

Тип: IExplorerBrowserEvents*

Указатель на интерфейс IExplorerBrowserEvents объекта, который следует уведомить о событиях IExplorerBrowser .

[out] pdwCookie

Тип: DWORD*

При возврате этим методом содержит маркер, который однозначно идентифицирует прослушиватель событий. Это позволяет подписаться на несколько прослушивателей событий одновременно.

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Этот метод вызывается реализацией IExplorerBrowserEvents. Реализующий (прослушиватель) получает рекомендации о событиях представления ExplorerBrowser и навигации путем обратного вызова методов IExplorerBrowserEvents.

Вызовите метод IExplorerBrowser::Advisory , чтобы инициировать подключение с рекомендацией перед первой навигацией IExplorerBrowser . Обратные вызовы прослушивателям событий выполняются при просмотре браузера.

Первый просмотр выполняется синхронно с вызовом метода IExplorerBrowser::BrowseToObject или аналогичного метода. Будущие обратные вызовы выполняются асинхронно по мере просмотра браузером.

Если подключение больше не требуется, вызовите метод IExplorerBrowser::Unadvise , чтобы завершить подключение.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	shobjidl_core.h (включая Shobjidl.h)

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

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