SHGetPathFromIDList(A)

アイテム ID リストをファイルシステムのパス名に変換します。

BOOL SHGetPathFromIDListA(
    LPCITEMIDLIST pidl,
    PTSTR         pszPath
);

SHELL32.DLL

引数

pidl

シェルネームスペースのルート（「ﾃﾞｽｸﾄｯﾌﾟ」フォルダ）からのフォルダの相対的な位置を指定するアイテム ID リストへのポインタ（PIDL）を指定します。

pszPath

変換されたパス名を格納するバッファのアドレスを指定します。このバッファのサイズは少なくとも 260 (MAX_PATH) バイト（Unicode 版の場合は 260 (MAX_PATH) 文字）以上でなくてはなりません。

戻り値

成功した場合は 1 (TRUE) が返ります。

失敗した場合は 0 (FALSE) が返ります。

解説

pidl パラメータで指定された PIDL がファイルシステム上のものでない場合は、この関数は失敗します。

pidl パラメータで指定された PIDL がショートカットファイルを表す場合、 pszPath パラメータがで指定されたバッファに格納されるパス名は、リンク先ファイルのパス名ではなく、ショートカットファイル自体のパス名になります。

対応情報

Shell32.dll Version 4.00 以降

Windows 95 以降 / Windows NT 4.0 以降