SHGetPathFromIDListW 函式 (shlobj_core.h)
將專案識別碼清單轉換為檔案系統路徑。
語法
BOOL SHGetPathFromIDListW(
[in] PCIDLIST_ABSOLUTE pidl,
[out] LPWSTR pszPath
);
參數
[in] pidl
類型:PCIDLIST_ABSOLUTE
項目識別子清單的位址,指定相對於命名空間根目錄的檔案或目錄位置(桌面)。
[out] pszPath
類型:LPTSTR
要接收檔案系統路徑之緩衝區的位址。 此緩衝區的大小必須至少MAX_PATH個字元。
傳回值
類型:BOOL
如果成功,則會傳回 TRUE;否則,FALSE。
言論
如果 pidl 參數所指定的位置不是文件系統的一部分,此函式將會失敗。
如果 pidl 參數指定快捷方式,pszPath 將包含快捷方式的路徑,而不是快捷方式的目標。
注意
shlobj_core.h 標頭會根據 UNICODE 預處理器常數的定義,將 SHGetPathFromIDList 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平臺 | 窗戶 |
標頭 | shlobj_core.h (包括 Shlobj.h, Shlobj_core.h) |
連結庫 | Shell32.lib |
DLL | Shell32.dll 版(4.0 版或更新版本) |
API 集 | ext-ms-win-shell-shell32-l1-2-2 (在 Windows 10 版本 10.0.14393 中引進) |