SymGetLineFromAddrW64

指定したアドレスに対応するソース行を検索する。(SymGetLineFromAddrW64)

SymGetLineFromAddrW64 hProcess, dwAddr, pdwDisplacement, Line

hProcess : [intptr] もともと SymInitialize 関数に渡したプロセスへのハンドル。
dwAddr : [int64] 行を検索する対象アドレス。アドレスは行境界上にある必要はない。アドレスが行の開始以降、終端より前に位置していれば、その行が検出される。
pdwDisplacement : [var] 行先頭からの変位 (バイト単位)、または 0。
Line : [var] IMAGEHLP_LINE64 構造体へのポインター。

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

解説

指定したアドレスに対応するソース行を検索する。(SymGetLineFromAddrW64)

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

[備考]
呼び出し元は SymGetLineFromAddr64 を呼び出す前に、Line バッファを適切に確保し、IMAGEHLP_LINE64
構造体の必須メンバーを設定しておく必要がある。この関数は別の関数によって再利用される可能性のあるバッファへのポインターを返す。したがって、返されたデータはすぐに別のバッファにコピーしておくこと。DbgHelp
関数はすべて、この関数を含めシングルスレッドである。したがって複数のスレッドから同時に呼び出すと、予期しない動作やメモリ破壊を引き起こす可能性が高い。これを避けるため、複数スレッドからの同時呼び出しはすべて同期する必要がある。Unicode
版を呼び出すには DBGHELP_TRANSLATE_TCHAR を定義する。SymGetLineFromAddrW64 は
Dbghelp.h で次のように定義されている。
（以下省略）

情報