FindExecutableImage

実行可能ファイルを検索する。

FindExecutableImage FileName, SymbolPath, ImageFilePath

FileName : [str] 検索するシンボルファイルの名前。このパラメーターには部分パスを指定できる。
SymbolPath : [str] シンボルファイルが置かれているパス。セミコロンで区切って複数のパスを指定できる。シンボルパスを取得するには SymGetSearchPath 関数を使う。
ImageFilePath : [str] 実行可能ファイルのフルパスを受け取るバッファへのポインター。

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

解説

実行可能ファイルを検索する。

[戻り値]
関数が成功した場合、戻り値は実行可能ファイルに対するオープン済みハンドルとなる。関数が失敗した場合、戻り値は NULL
となる。拡張エラー情報を取得するには GetLastError を呼び出す。

[備考]
FindExecutableImage
関数は、単一の関数呼び出しで複数のディレクトリを対象に実行可能ファイルを検索できるように用意されている。SymbolPath
パラメーターにはセミコロン (;)
で区切って複数のパスを指定できる。複数のパスを指定した場合、関数は各ディレクトリツリーを対象に実行可能ファイルを検索する。ファイルが見つかった時点で検索は終了する。したがって
SymbolPath にはパスを正しい順序で指定すること。DbgHelp
関数はすべて、この関数を含めシングルスレッドである。したがって複数のスレッドから同時に呼び出すと、予期しない動作やメモリ破壊を引き起こす可能性が高い。これを避けるため、複数スレッドからの同時呼び出しはすべて同期する必要がある。

情報