SHCreateShellFolderView 関数 (shlobj_core.h)

  • [アーティクル]

既定のシェル フォルダー ビュー オブジェクト (DefView) の新しいインスタンスを作成します。

構文

SHSTDAPI SHCreateShellFolderView(
  [in]  const SFV_CREATE *pcsfv,
  [out] IShellView       **ppsv
);

パラメーター

[in] pcsfv

型: const SFV_CREATE*

シェル フォルダー ビュー オブジェクトのこの インスタンスの作成に使用される詳細を記述するSFV_CREATE構造体へのポインター。

[out] ppsv

種類: IShellView**

この関数が正常に返されると、新しい IShellView オブジェクトへのインターフェイス ポインターが含まれます。 失敗した場合、この値は NULL です。

戻り値

種類: HRESULT

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

注釈

SHCreateShellFolderView は、さまざまなシナリオに参加し、ビューに新しい機能を提供し、他のオブジェクトと対話するための要素の柔軟性が高いため、 SHCreateShellFolderViewEx よりも推奨されます。

IShellView の複数のインスタンスを処理する場合は、既定のシェル フォルダー ビュー オブジェクトを確認する必要があります。 これを行うには、IID_CDefView IID を使用して、オブジェクトで QueryInterface を呼び出します。 この呼び出しは、既定のシェル フォルダー ビュー オブジェクトで行われた場合にのみ成功します。

既定のシェル フォルダー ビュー オブジェクトを使用するデータ ソースでは、次のインターフェイスを実装する必要があります。

必要に応じて、 IPersistFolder3 を実装することもできます。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー shlobj_core.h (Shlobj.h を含む)
Library Shell32.lib
[DLL] Shell32.dll (バージョン 5.0 以降)
API セット ext-ms-win-shell-shell32-l1-2-2 (Windows 10 バージョン 10.0.14393 で導入)

こちらもご覧ください

SFV_CREATE

SHCreateShellFolderViewEx