SHGetPathFromIDListEx 関数 (shlobj_core.h)

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

構文

BOOL SHGetPathFromIDListEx(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [out] PWSTR             pszPath,
        DWORD             cchPath,
        GPFIDL_FLAGS      uOpts
);

パラメーター

[in] pidl

種類: PCIDLIST_ABSOLUTE

名前空間 (デスクトップ) のルートを基準としたファイルまたはディレクトリの場所を指定する項目識別子リストへのポインター。

[out] pszPath

種類: PWSTR

この関数が呼び出されると、ファイル システム パスを受け取る null で終わる Unicode バッファーが渡されます。 このバッファーのサイズは cchPath です。

この関数が戻るときに、ファイル システム パスを含む null で終わる Unicode バッファーのアドレスが格納されます。 このバッファーのサイズは cchPath です。

cchPath

型: DWORD

pszPath が指すバッファーのサイズ (文字数)。

uOpts

種類: GPFIDL_FLAGS

これらのフラグは、返されるパスの種類を決定します。

GPFIDL_DEFAULT (0x0000)

Win32 ファイル名、サーバー、ルート ドライブが含まれています。

GPFIDL_ALTNAME (0x0001)

短いファイル名を使用します。

GPFIDL_UNCPRINTER (0x0002)

UNC プリンター名項目を含めます。

戻り値

種類: BOOL

成功した場合は TRUE を 返します。それ以外の場合は FALSE。

注釈

UNC プリンター名を除き、 pidl パラメーターで指定された場所がファイル システムの一部でない場合、この関数は失敗します。

pidl パラメーターにショートカットが指定されている場合、pszPath にはショートカットのターゲットではなく、ショートカットへのパスが含まれます。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shlobj_core.h (Shlobj.h を含む)
Library	Shell32.lib
[DLL]	Shell32.dll
API セット	ext-ms-win-shell-shell32-l1-2-2 (Windows 10 バージョン 10.0.14393 で導入)

こちらもご覧ください

SHParseDisplayName