FindExecutableImageEx

FindExecutableImageEx 関数 (dbghelp.h) は、指定した実行可能ファイルを検索する。

FindExecutableImageEx FileName, SymbolPath, ImageFilePath, Callback, CallerData

FileName : [str] 検索するシンボルファイルの名前。このパラメーターには部分パスを指定できる。
SymbolPath : [str] シンボルファイルが置かれているパス。この文字列にはセミコロンで区切って複数のパスを指定できる。シンボルパスを取得するには SymGetSearchPath 関数を使う。
ImageFilePath : [str] 実行可能ファイルのフルパスを受け取るバッファへのポインター。
Callback : [int] 正しい実行可能ファイルが見つかったか、または検索を続行すべきかを判定するアプリケーション定義のコールバック関数。詳細は FindExecutableImageProc を参照。
CallerData : [intptr] コールバック関数に渡す省略可能なユーザー定義データ。このパラメーターには NULL を指定できる。

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

解説

FindExecutableImageEx 関数 (dbghelp.h) は、指定した実行可能ファイルを検索する。

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

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

情報