PathFindOnPathW 関数 (shlwapi.h)

ファイルを検索します。

構文

BOOL PathFindOnPathW(
  [in, out]      LPWSTR   pszPath,
  [in, optional] PZPCWSTR 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 バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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