SHCreateItemInKnownFolder 関数 (shobjidl_core.h)
既知のフォルダー内に存在する 1 つのファイルのシェル項目オブジェクトを作成します。
構文
SHSTDAPI SHCreateItemInKnownFolder(
[in] REFKNOWNFOLDERID kfid,
DWORD dwKFFlags,
[in, optional] PCWSTR pszItem,
[in] REFIID riid,
[out] void **ppv
);
パラメーター
[in] kfid
型: REFKNOWNFOLDERID
アイテムを含むフォルダーを識別する GUID である KNOWNFOLDERID への参照。
dwKFFlags
型: DWORD
オブジェクトの取得で特別なオプションを指定するフラグ。 この値には 0 を指定できます。それ以外の場合は、KNOWN_FOLDER_FLAG値の 1 つ以上。
[in, optional] pszItem
種類: PCWSTR
新しい項目のファイル名を Unicode 文字列として含む null で終わるバッファーへのポインター。 このパラメーターには NULL を指定することもできます。 この場合、既知のフォルダー自体を表す IShellItem が作成されます。
[in] riid
型: REFIID
ppv を介して取得された項目を表すインターフェイスの IID への参照。 通常、この値はIID_IShellItemまたはIID_IShellItem2です。
[out] ppv
型: void**
この関数が正常に返されると、 riid で要求されたインターフェイス ポインターが含まれます。 これは通常、 IShellItem または IShellItem2 です。
戻り値
型: HRESULT
この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | shobjidl_core.h (Shobjidl.h を含む) |
| [DLL] | Shell32.dll |
| API セット | ext-ms-win-shell-shell32-l1-2-0 (Windows 8.1 で導入) |