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

[アーティクル]
08/26/2023

項目識別子リスト (PIDL) へのポインターを参照します。

構文

HRESULT BrowseToIDList(
  [in] PCUIDLIST_RELATIVE pidl,
  [in] UINT               uFlags
);

パラメーター

[in] pidl

種類: PCUIDLIST_RELATIVE

移動先としてオブジェクトの場所を指定する const ITEMIDLIST (アイテム識別子リスト) へのポインター。このパラメーターは、NULL でもかまいません。詳細については、「解説」を参照してください。

[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 で指定されたフラグが組み込みの TravelLog (つまり、SBSP_NAVIGATEBACKまたはSBSP_NAVIGATEFORWARD) を通るナビゲーションを示している場合、パラメーター pidl は NULL になる可能性があります。

このメソッドは、shobjidl.h ファイルにリストされている SBSP フラグのサブセットのみをサポートします。したがって、 uFlags でSBSP_NEWBROWSERまたはSBSP_EXPLOREMODEが指定されている場合、このメソッドはE_INVALIDARGを返します。

要件


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