SymEnumSourceLines

SymEnumSourceLines 関数 (dbghelp.h) は、モジュール内のすべてのソース行を列挙する。

SymEnumSourceLines hProcess, Base, Obj, File, Line, Flags, EnumLinesCallback, UserContext

hProcess : [intptr] プロセスへのハンドル。このハンドルは事前に SymInitialize 関数に渡しておく必要がある。
Base : [int64] モジュールのベースアドレス。
Obj : [str] モジュール内の .obj ファイルの名前。列挙はこのファイルに限定される。このパラメーターが NULL または空文字列の場合、すべての .obj ファイルが検索される。
File : [str] 検索対象のソースファイル名を示すワイルドカード式。このパラメーターが NULL または空文字列の場合、すべてのファイルが検索される。
Line : [int] モジュール内の行番号。列挙はこの行に限定される。このパラメーターが 0 の場合、すべての行が検索される。
Flags : [int] このパラメーターが ESLFLAG_FULLPATH の場合、関数は File パラメーターのフルパスに対して一致を取る。
EnumLinesCallback : [int] 行情報を受け取る SymEnumLinesProc コールバック関数。
UserContext : [intptr] コールバック関数に渡されるユーザー定義の値、または NULL。このパラメーターは通常、コールバック関数にコンテキストを提供するデータ構造へのポインターを渡すために使用される。

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

解説

SymEnumSourceLines 関数 (dbghelp.h) は、モジュール内のすべてのソース行を列挙する。

[戻り値]
関数が成功した場合、戻り値は TRUE となる。
関数が失敗した場合、戻り値は FALSE となる。拡張エラー情報を取得するには GetLastError を呼び出す。

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

情報