SymGetLineNext64

次のソース行の行情報を取得する。(SymGetLineNext64)

SymGetLineNext64 hProcess, Line

hProcess : [intptr] もともと SymInitialize 関数に渡したプロセスのハンドル。
Line : [var] 行情報を保持する IMAGEHLP_LINE64 構造体へのポインター。

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

解説

次のソース行の行情報を取得する。(SymGetLineNext64)

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

[備考]
SymGetLineNext64 関数では、IMAGEHLP_LINE64 構造体が有効なデータを保持している必要があり、通常は
SymGetLineFromAddr64 または SymGetLineFromName64
関数の呼び出しで得たものを使用する。この構造体には、順序上の次の行の行情報が格納される。この関数は他の関数から再利用される可能性があるバッファへのポインタを返すため、返されたデータはただちに別のバッファへコピーすること。この関数を含め、すべての
DbgHelp
関数はシングルスレッドである。そのため複数のスレッドから同時に呼び出すと、予期しない動作やメモリ破壊を招く可能性が高い。これを避けるには、複数スレッドからの並行呼び出しをすべて同期する必要がある。この関数の
Unicode 版を呼び出すには DBGHELP_TRANSLATE_TCHAR を定義する。SymGetLineNextW64 は
Dbghelp.h で次のように定義されている。
（以下省略）

情報