SHGetPathFromIDListEx

アイテム識別子リストをファイルシステムパスに変換する。この関数は、文字列バッファーの初期サイズを設定し、以下のオプションを宣言できるようにすることで SHGetPathFromIDList を拡張する。

SHGetPathFromIDListEx pidl, pszPath, cchPath, uOpts

pidl : [var] 型: PCIDLIST_ABSOLUTE 名前空間のルート (デスクトップ) を基準としたファイルまたはディレクトリの場所を指定するアイテム識別子リストへのポインター。
pszPath : [wstr] 型: PWSTR この関数が呼び出されるとき、ファイルシステムパスを受け取る null 終端の Unicode バッファーが渡される。このバッファーのサイズは cchPath である。
cchPath : [int] 型: DWORD pszPath が指すバッファーのサイズ (文字単位)。
uOpts : [int] 型: GPFIDL_FLAGS これらのフラグは返されるパスの種類を決定する。

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

解説

アイテム識別子リストをファイルシステムパスに変換する。この関数は、文字列バッファーの初期サイズを設定し、以下のオプションを宣言できるようにすることで
SHGetPathFromIDList を拡張する。

[戻り値]
型: BOOL 成功した場合は TRUE を、それ以外の場合は FALSE を返す。

[備考]
UNC プリンター名を除き、pidl パラメーターで指定された場所がファイルシステムの一部でない場合、この関数は失敗する。pidl
パラメーターがショートカットを指定する場合、pszPath
にはショートカットのターゲットではなく、ショートカット自体へのパスが格納される。

情報

プラグイン / モジュール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