共用方式為

PathFindOnPathW 函式 （shlwapi.h）

  • 發行項

搜尋檔案。

語法

BOOL PathFindOnPathW(
  [in, out]      LPWSTR   pszPath,
  [in, optional] PZPCWSTR ppszOtherDirs
);

參數

[in, out] pszPath

類型：LPTSTR

長度為 null 的字串指標MAX_PATH，其中包含要搜尋的檔名。 如果搜尋成功，此參數會用來傳回完整路徑名稱。

[in, optional] ppszOtherDirs

類型：LPCTSTR*

要先搜尋之目錄的選擇性 Null 終止陣列。 這個值可以 NULL。

傳回值

類型：BOOL

如果成功，則傳回 true true，否則會 傳回 false。

言論

PathFindOnPath 會搜尋 pszFile 所指定的檔案。 如果在 ppszOtherDirs中未指定任何目錄，它會搜尋 System32 和 PATH 環境變數中指定的目錄，嘗試尋找檔案。 若要加速程式或啟用 PathFindOnPath 來搜尋更廣泛的目錄，請使用 ppszOtherDirs 參數來指定要先搜尋的一或多個目錄。 如果多個檔案具有 pszFile所指定的名稱，PathFindOnPath 會傳回它找到的第一個實例。

注意

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

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional、Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 shlwapi.h
連結庫 Shlwapi.lib
DLL Shlwapi.dll （4.71 版或更新版本）