PathResolve 函式 (shlobj_core.h)
[PathResolve 可用於需求一節中指定的作業系統。 它可能會在後續版本中改變或無法使用。]
將相對或未限定的路徑名稱轉換為完整路徑名稱。
語法
int PathResolve(
[in, out] PWSTR pszPath,
[in, optional] PZPCWSTR dirs,
UINT fFlags
);
參數
[in, out] pszPath
類型： PWSTR
Null 終止的 Unicode 字串，其中包含要解析的路徑。 當函式傳回時，字串會包含對應的完整路徑。 此緩衝區長度至少應MAX_PATH個字元。
[in, optional] dirs
類型： PZPCWSTR
在無法從 pszPath 解析路徑的情況下，要先搜尋的選擇性 Null 終止目錄陣列指標。 此值可以是 NULL。
fFlags
類型： UINT
指定函式運作方式的旗標。
PRF_VERIFYEXISTS
如果檔案存在已驗證，則傳回 TRUE ;否則 為 FALSE。
PRF_TRYPROGRAMEXTENSIONS
尋找附加下列延伸模組的指定路徑：.pif、.com、.bat、.cmd、.lnk和 .exe。
PRF_FIRSTDIRDEF
請先查看 dirs 所指定的目錄或目錄。
PRF_DONTFINDLNK
忽略.lnk檔案。
PRF_REQUIREABSOLUTE
需要絕對 (完整) 路徑。
傳回值
類型： int
除非已設定PRF_VERIFYEXISTS，否則會傳回 TRUE。 如果已設定該旗標，則如果檔案已驗證為存在，則函式會傳回 TRUE ，否則 傳回 FALSE 。 它也會設定ERROR_FILE_NOT_FOUND錯誤碼，您可以藉由呼叫 GetLastError 來擷取。
備註
FALSE 傳回值不一定表示檔案不存在。 這可能表示函式只是無法從提供的資訊中尋找檔案。
如果 PathResolve 無法解析 pszPath 中指定的路徑，它會使用 pszPath 和 dirs 作為參數呼叫 PathFindOnPath。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | shlobj_core.h (包含 Shlobj.h) |
| 程式庫 | Shell32.lib |
| Dll | Shell32.dll (5.0 版或更新版本) |
| API 集合 | ext-ms-win-shell32-l1-2-2 (於 Windows 10 10.0.14393 版中引進) |