IExplorerBrowser::Advise メソッド (shobjidl_core.h)

イベント コールバックの IExplorerBrowser との接続を開始します。

構文

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

パラメーター

[in] psbe

種類: IExplorerBrowserEvents*

IExplorerBrowser イベントの推奨されるオブジェクトの IExplorerBrowserEvents インターフェイスへのポインター。

[out] pdwCookie

種類: DWORD*

このメソッドが戻るとき、 には、イベント リスナーを一意に識別するトークンが含まれます。 これにより、一度に複数のイベント リスナーをサブスクライブできます。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

このメソッドは、 IExplorerBrowserEvents の実装者によって呼び出されます。 実装者 (リスナー) は、 IExplorerBrowserEvents のメソッドのコールバックによって、ExplorerBrowser ビューとナビゲーション イベントを使用することをお勧めします。

IExplorerBrowser::Advise を呼び出して、最初の IExplorerBrowser ナビゲーションの前にアドバイザリ接続を開始します。 イベント リスナーへのコールバックは、ブラウザーが参照している間に行われます。

最初の参照は、 IExplorerBrowser::BrowseToObject または同様のメソッドの呼び出しに対して同期的に行われます。 今後のコールバックは、ブラウザーが参照するにつれて非同期的に行われます。

接続が不要になったら、メソッド IExplorerBrowser::Unadvise を呼び出して接続を終了します。

要件

こちらもご覧ください

IExplorerBrowser

OnNavigationComplete

OnNavigationFailed

OnViewCreated