SymGetLineFromNameW64

指定したモジュール、ファイル名、行番号に対するソース行を検索する。(SymGetLineFromNameW64)

SymGetLineFromNameW64 hProcess, ModuleName, FileName, dwLineNumber, plDisplacement, Line

hProcess : [intptr] もともと SymInitialize 関数に渡したプロセスへのハンドル。
ModuleName : [wstr] 行を検索する対象モジュールの名前。
FileName : [wstr] 行を検索する対象ファイル名。アプリケーションが同名のソースファイルを複数持つ場合は、必ずフルパスを指定すること。
dwLineNumber : [int] 検索対象の行番号。
plDisplacement : [var] 行先頭からの変位 (バイト単位)、または 0。
Line : [var] IMAGEHLP_LINE64 構造体へのポインター。

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

解説

指定したモジュール、ファイル名、行番号に対するソース行を検索する。(SymGetLineFromNameW64)

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

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

情報