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 で導入) |