PathFindOnPathA 関数 (shlwapi.h)

ファイルを検索します。

構文

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

パラメーター

[in, out] pszPath

種類: LPTSTR

検索するファイル名を含む長さMAX_PATHの null で終わる文字列へのポインター。 検索が成功した場合、このパラメーターを使用して完全修飾パス名が返されます。

[in, optional] ppszOtherDirs

種類: LPCTSTR*

最初に検索するディレクトリの null で終わる省略可能な配列。 この値は NULL にすることができます。

戻り値

種類: BOOL

成功した場合は TRUE 、それ以外の場合 は FALSE を 返します。

注釈

PathFindOnPath は 、pszFile で指定されたファイルを検索します。 ppszOtherDirs でディレクトリが指定されていない場合は、System32 などの標準ディレクトリと PATH 環境変数で指定されたディレクトリを検索して、ファイルの検索を試みます。 プロセスを迅速化するか 、PathFindOnPath で広範なディレクトリを検索できるようにするには、 ppszOtherDirs パラメーターを使用して、最初に検索する 1 つ以上のディレクトリを指定します。 複数のファイルに pszFile で指定された名前がある場合、 PathFindOnPath は最初に見つけたインスタンスを返します。

注意

shlwapi.h ヘッダーは PathFindOnPath をエイリアスとして定義します。これは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shlwapi.h
Library	Shlwapi.lib
[DLL]	Shlwapi.dll (バージョン 4.71 以降)