SHGetNameFromIDList

IDList で識別される項目の表示名を取得する。

SHGetNameFromIDList pidl, sigdnName, ppszName

pidl : [var] 型: PCIDLIST_ABSOLUTE 項目を識別する PIDL。
sigdnName : [int] 型: SIGDN 取得する表示名の種類を指定する SIGDN 列挙体の値。
ppszName : [var] 型: PWSTR* この関数が成功した場合に、取得した表示名へのポインターのアドレスを受け取る値。

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

解説

IDList で識別される項目の表示名を取得する。

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

[備考]
ppszName が指す文字列を不要になった時点で解放するのは呼び出し側の責任である。メモリを解放するには *ppszName に対して
CoTaskMemFree を呼び出す。

情報

プラグイン / モジュールshell32.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の shell32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_shell32_gen2.hs