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

[アーティクル]
03/02/2024

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

構文

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 で適切に応答する必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)

次の方法で共有