SHGetPathFromIDListA 函式 (shlobj_core.h)

將專案識別碼清單轉換為檔案系統路徑。

語法

BOOL SHGetPathFromIDListA(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [out] LPSTR             pszPath
);

[in] pidl

類型： PCIDLIST_ABSOLUTE

專案識別碼清單的位址，指定相對於桌面) (命名空間根目錄的檔案或目錄位置。

[out] pszPath

類型： LPTSTR

要接收檔案系統路徑之緩衝區的位址。此緩衝區的大小必須至少MAX_PATH個字元。

類型： BOOL

如果成功，則傳回 TRUE ;否則為 FALSE。

如果 pidl 參數所指定的位置不是檔案系統的一部分，此函式將會失敗。

如果 pidl 參數指定快捷方式， pszPath 將會包含快捷方式的路徑，而不是快捷方式的目標。

注意

shlobj_core.h 標頭會將 SHGetPathFromIDList 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。


最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	shlobj_core.h (包含 Shlobj.h、Shlobj_core.h)
程式庫	Shell32.lib
Dll	Shell32.dll (4.0 版或更新版本)
API 集合	ext-ms-win-shell32-l1-2-2 (在 Windows 10 10.0.14393 版中引進)