FindDebugInfoFile

デバッグ (.dbg) ファイルを検索する。

FindDebugInfoFile FileName, SymbolPath, DebugFilePath

FileName : [str] 取得したい .dbg ファイルの名前。部分パスを指定できる。
SymbolPath : [str] シンボルファイルが置かれているパス。セミコロンで区切って複数のパスを指定できる。シンボルパスを取得するには SymGetSearchPath 関数を使う。
DebugFilePath : [str] .dbg ファイルのフルパスを受け取るバッファへのポインター。

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

解説

デバッグ (.dbg) ファイルを検索する。

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

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

情報