SHCreateItemInKnownFolder

既知フォルダ内に存在する単一ファイルに対するシェルアイテムオブジェクトを生成する。

SHCreateItemInKnownFolder kfid, dwKFFlags, pszItem, riid, ppv

kfid : [var] 型: REFKNOWNFOLDERID アイテムを格納するフォルダを示す KNOWNFOLDERID（GUID）への参照。
dwKFFlags : [int] 型: DWORD オブジェクト取得時の特別なオプションを指定するフラグ。この値は 0 でも、KNOWN_FOLDER_FLAG の値の 1 つ以上でも構わない。
pszItem : [wstr] 型: PCWSTR 新しいアイテムのファイル名を Unicode 文字列として含むヌル終端バッファへのポインタ。このパラメータは NULL でも構わない。NULL の場合、既知フォルダ自体を表す IShellItem が生成される。
riid : [var] 型: REFIID ppv を通じて取得する、アイテムを表すインタフェースの IID への参照。通常は IID_IShellItem または IID_IShellItem2 である。
ppv : [var] 型: void** この関数が成功して戻る際に、riid で要求されたインタフェースポインタを格納する。通常は IShellItem または IShellItem2 である。

(プラグイン / モジュール : shell32.dll)

解説

既知フォルダ内に存在する単一ファイルに対するシェルアイテムオブジェクトを生成する。

[戻り値]
型: HRESULT 関数が成功した場合は S_OK を返す。そうでない場合は HRESULT エラーコードを返す。

情報