SymFindDebugInfoFile

SymFindDebugInfoFile 関数 (dbghelp.h) は、プロセスの検索パス内から .dbg ファイルを検索する。

SymFindDebugInfoFile hProcess, FileName, DebugFilePath, Callback, CallerData

hProcess : [intptr] もともと SymInitialize 関数に渡したプロセスへのハンドル。
FileName : [str] .dbg ファイルの名前。部分パスを指定できる。
DebugFilePath : [str] .dbg ファイルの完全修飾パス。このバッファは少なくとも MAX_PATH 文字分の容量が必要。
Callback : [int] 正しいファイルが見つかったか、または検索を続行すべきかを判定するアプリケーション定義のコールバック関数。詳細は FindDebugInfoFileProc を参照。
CallerData : [intptr] ユーザー定義の値、または NULL。この値はそのままコールバック関数に渡される。このパラメーターは通常、コールバック関数にコンテキストを提供するデータ構造へのポインターを渡すために使用される。

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

解説

SymFindDebugInfoFile 関数 (dbghelp.h) は、プロセスの検索パス内から .dbg ファイルを検索する。

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

[備考]
この関数は SymInitialize または SymSetSearchPath 関数で設定された検索パスを使用する。DbgHelp
関数はすべて、この関数を含めシングルスレッドである。したがって複数のスレッドから同時に呼び出すと、予期しない動作やメモリ破壊を引き起こす可能性が高い。これを避けるため、複数スレッドからの同時呼び出しはすべて同期する必要がある。Unicode
版を呼び出すには DBGHELP_TRANSLATE_TCHAR を定義する。

情報