SHParseDisplayName

シェル名前空間オブジェクトの表示名をアイテム識別子リストに変換し、オブジェクトの属性を返す。この関数は文字列をアイテム識別子リスト (PIDL) へのポインターに変換するための推奨方法である。

SHParseDisplayName pszName, pbc, ppidl, sfgaoIn, psfgaoOut

pszName : [wstr] 型: LPCWSTR 解析する表示名を含むゼロ終端のワイド文字列へのポインター。
pbc : [var] 型: IBindCtx* 解析操作を制御するバインドコンテキスト。このパラメーターは通常 NULL に設定する。
ppidl : [var] 型: PIDLIST_ABSOLUTE* オブジェクトのアイテム識別子リストを受け取る ITEMIDLIST 型の変数へのポインターのアドレス。エラーが発生した場合、このパラメーターは NULL に設定される。
sfgaoIn : [int] 型: SFGAOF クエリする属性を指定する ULONG 値。1 つ以上の属性をクエリするには、関心のある属性を表すフラグでこのパラメーターを初期化する。利用可能な SFGAO フラグの一覧は IShellFolder::GetAttributesOf を参照。
psfgaoOut : [var] 型: SFGAOF* ULONG へのポインター。戻り時に、sfgaoIn で要求されたうちオブジェクトに対して true である属性が設定される。オブジェクトの属性フラグは 0 または SFGAO フラグの組み合わせとなる。利用可能な SFGAO フラグの一覧は IShellFolder::GetAttributesOf を参照。

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

解説

シェル名前空間オブジェクトの表示名をアイテム識別子リストに変換し、オブジェクトの属性を返す。この関数は文字列をアイテム識別子リスト
(PIDL) へのポインターに変換するための推奨方法である。

[戻り値]
型: HRESULT この関数が成功した場合は S_OK を返す。失敗した場合は HRESULT エラーコードを返す。

[備考]
この関数はバックグラウンドスレッドから呼び出すべきである。そうしないと UI が応答しなくなる可能性がある。

情報