Метод IExplorerBrowser::Advise (shobjidl_core.h)
Инициирует соединение с 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) |