NeedCurrentDirectoryForExePathW

指定した実行可能ファイルの検索パスにカレントディレクトリを含めるべきかを判定する。(Unicode)

NeedCurrentDirectoryForExePathW ExeName

ExeName : [wstr] 実行可能ファイルの名前。

(プラグイン / モジュール : kernel32.dll)

解説

指定した実行可能ファイルの検索パスにカレントディレクトリを含めるべきかを判定する。(Unicode)

[戻り値]
カレントディレクトリを検索パスに含めるべき場合、戻り値は TRUE である。そうでない場合、戻り値は FALSE である。

[備考]

この関数は、呼び出し側が相対的な実行可能ファイル名を絶対名へ明示的に解決しなければならない場合にのみ呼ぶべきである。CreateProcess
が相対的な実行可能ファイル名で呼び出された場合、自動的に実行可能ファイルを検索し、検索パスを決定するためにこの関数を呼ぶ。ほとんどのシステム関数は独自のパス解決を行うため、指定した実行可能ファイルのカレントディレクトリに基づく検索パスを解決しようとする場合にのみこの関数を呼ぶべきである。この関数が返す値は
NoDefaultCurrentDirectoryInExePath
環境変数の値によって決まる。ただしこの環境変数のレジストリ上の場所は変わり得るため、環境変数を直接確認するのではなくこの関数を呼ぶべきである。ExeName
引数の値にバックスラッシュ (\\) が含まれている場合、この関数は常に TRUE
を返す。バックスラッシュを含まない場合は、NoDefaultCurrentDirectoryInExePath
環境変数の存在のみが確認され、その値は参照されない。CreateProcess
の既定の検索パス解決アルゴリズムに頼るのではなく、この関数を呼ぶべき例として "cmd.exe" がある。cmd.exe は
CreateProcess を呼ぶ前に独自のパス解決を行うため、この関数を呼んでコマンド検索パスを決定する。この関数が TRUE
を返した場合、cmd.exe は実行可能ファイルの検索に ".;%PATH%" というパスを使う。FALSE を返した場合、cmd.exe
は検索に "%PATH%" を使う。
> [!NOTE] > processenv.h ヘッダは NeedCurrentDirectoryForExePath
を、UNICODE プリプロセッサ定数の定義に基づいて ANSI 版または Unicode
版を自動選択するエイリアスとして定義している。エンコーディング中立なエイリアスと、エンコーディング中立でないコードを混在させると、コンパイル時または実行時エラーとなる不一致を生じ得る。詳細は
[関数プロトタイプの慣例](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報