PathFindOnPathA 函式 (shlwapi.h)

  • 發行項

搜尋檔案。

語法

BOOL PathFindOnPathA(
  [in, out]      LPSTR   pszPath,
  [in, optional] PZPCSTR ppszOtherDirs
);

參數

[in, out] pszPath

類型： LPTSTR

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

[in, optional] ppszOtherDirs

類型： LPCTSTR*

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

傳回值

類型： BOOL

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

備註

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

注意

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

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 shlwapi.h
程式庫 Shlwapi.lib
Dll Shlwapi.dll (4.71 版或更新版本)