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 で適切に応答する必要があります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | shobjidl_core.h (Shobjidl.h を含む) |