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

オブジェクトを参照します。

構文

HRESULT BrowseToObject(
  [in] IUnknown *punk,
  [in] UINT     uFlags
);

パラメーター

[in] punk

種類: IUnknown*

参照するオブジェクトへのポインター。 オブジェクトを参照できない場合は、エラー値が返されます。

[in] uFlags

型: UINT

pidl のカテゴリを指定する フラグ。 これは、ナビゲーションの実行方法に影響します。 値 0、または次の値のビットごとの組み合わせである必要があります。

SBSP_ABSOLUTE

デスクトップに対する相対絶対 PIDL。

SBSP_RELATIVE

現在のフォルダーに対する相対 PIDL。

SBSP_PARENT

親フォルダーを参照し、PIDL を無視します。

SBSP_NAVIGATEBACK

戻り、PIDL を無視します。

SBSP_NAVIGATEFORWARD

前に移動し、PIDL を無視します。

SBSP_KEEPWORDWHEELTEXT

Windows Vista 以降。 このフラグは、WordWheel によって入力された検索テキスト (Windows エクスプローラーの [検索] ボックス) をこのナビゲーション中に保持し、新しい場所のアイテムが前の場所でフィルター処理されたのと同じ方法でフィルター処理されるようにすることを示します。

戻り値

種類: HRESULT

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

注釈

uFlags には、ナビゲーションを示すフラグを除き、 EXPLORER_BROWSER_FILL_FLAGS または BrowseObject の wFlags パラメーターで定義されているフラグのいずれかを指定できます。

このメソッドは GetIDList を 呼び出し、返された pidl を参照します。 これは IExplorerBrowser::BrowseToIDList と同じように動作しますが、 パンク を NULL にすることはできません。 標準的な使用方法は、 IShellFolder または IShellItem を参照することです。 渡されたオブジェクトを参照できない場合は、エラーが返されます。 参照できるオブジェクトは、 IPersistFolder2 または IPersistIDList を実装します。

IExplorerBrowser の最初のナビゲーションは同期です。 その後、すべてのナビゲーションが非同期になります。 その結果、保留中のナビゲーションを適切に設定した場合、 IExplorerBrowser::BrowseToObject の呼び出しは成功しますが、ナビゲーションが成功するとは限りません。 成功と失敗を通知するには、クライアントは IExplorerBrowserEvents を実装し、 OnNavigationComplete と OnNavigationFailed で適切に応答する必要があります。

要件