SHOpenFolderAndSelectItems 関数 (shlobj_core.h)

特定のフォルダー内の指定した項目が選択された Windows エクスプローラー ウィンドウを開きます。

構文

SHSTDAPI SHOpenFolderAndSelectItems(
  [in]           PCIDLIST_ABSOLUTE     pidlFolder,
                 UINT                  cidl,
  [in, optional] PCUITEMID_CHILD_ARRAY apidl,
                 DWORD                 dwFlags
);

パラメーター

[in] pidlFolder

種類: PCIDLIST_ABSOLUTE

フォルダーを指定する完全修飾項目 ID リストへのポインター。

cidl

型: UINT

選択配列 apidl 内の項目の数。 cidl が 0 の場合、pidlFolder は、選択する 1 つの項目を記述する完全に指定された ITEMIDLIST を指す必要があります。 この関数は、親フォルダーを開き、その項目を選択します。

[in, optional] apidl

種類: PCUITEMID_CHILD_ARRAY

PIDL 構造体の配列へのポインター。各構造体は、 pidlFolder によって参照されるターゲット フォルダー内で選択する項目です。

dwFlags

型: DWORD

省略可能なフラグ。 Windows XP では、このパラメーターは無視されます。 Windows Vista では、次のフラグが定義されています。

OFASI_EDIT (0x0001)

項目を選択し、その名前を編集モードにします。 このフラグは、1 つの項目が選択されている場合にのみ使用できます。 複数の項目を選択した場合、無視されます。

OFASI_OPENDESKTOP (0x0002)

Windows エクスプローラー ウィンドウではなく、デスクトップ上の項目を選択します。 開いているウィンドウの後ろにデスクトップが隠れている場合、デスクトップは表示されないことに注意してください。

戻り値

型: HRESULT

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

注釈

SHOpenFolderAndSelectItems を使用する前に、CoInitialize または CoInitializeEx を呼び出す必要があります。 これを行わないと、 SHOpenFolderAndSelectItems が 失敗します。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	shlobj_core.h (Shlobj.h を含む)
Library	Shell32.lib
[DLL]	Shell32.dll (バージョン 6.0 以降)