SHCreateItemFromParsingName

解析名からシェルアイテムオブジェクトを生成し初期化する。

SHCreateItemFromParsingName pszPath, pbc, riid, ppv

pszPath : [wstr] 型: PCWSTR 表示名へのポインタ。
pbc : [var] 型: IBindCtx* 省略可能。解析関数への入力および出力としてパラメータを渡すために使うバインドコンテキストへのポインタ。これらのパラメータは多くの場合データソース固有であり、データソース所有者によって文書化されている。たとえばファイルシステムデータソースは、解析対象の名前（WIN32_FIND_DATA 構造体として）を STR_FILE_SYS_BIND_DATA バインドコンテキストパラメータを使って受け付ける。
riid : [var] 型: REFIID ppv を通じて取得するインタフェースの IID への参照。通常は IID_IShellItem または IID_IShellItem2 である。
ppv : [var] 型: void** このメソッドが成功して戻る際に、riid で要求されたインタフェースポインタを格納する。通常は IShellItem または IShellItem2 である。

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

解説

解析名からシェルアイテムオブジェクトを生成し初期化する。

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

[備考]
Objbase.h で定義されている IID_PPV_ARGS マクロを使って riid と ppv
のパラメータをまとめることが推奨される。このマクロは ppv の値が指すインタフェースに基づいて正しい IID を提供するため、riid
のコーディングミスによる予期しない結果の可能性を排除できる。

情報