SymGetSymFromAddr64

指定されたアドレスに対するシンボルを特定する。(SymGetSymFromAddr64)

SymGetSymFromAddr64 hProcess, qwAddr, pdwDisplacement, Symbol

hProcess : [intptr] もともと SymInitialize 関数に渡したプロセスのハンドル。
qwAddr : [int64] シンボルを特定するアドレス。アドレスはシンボル境界に一致していなくてもよい。アドレスがシンボルの先頭以降、かつシンボルの末尾（シンボルの先頭にシンボルサイズを加えた位置）より前にあれば、シンボルが見つかる。
pdwDisplacement : [var] シンボルの先頭からのオフセット、または 0。
Symbol : [var] IMAGEHLP_SYMBOL64 構造体へのポインタ。

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

解説

指定されたアドレスに対するシンボルを特定する。(SymGetSymFromAddr64)

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

[備考]
SymGetSymFromAddr64
関数は、指定されたアドレスに対するシンボルを特定する。まず該当するアドレスを含むモジュールがモジュール群から検索される。モジュールが見つかると、そのシンボルテーブルから一致するシンボルが検索される。シンボルが見つかると、呼び出し側が用意した
Symbol バッファにシンボル情報がコピーされる。SymGetSymFromAddr64 を呼び出す前に、呼び出し側で Symbol
バッファを適切に確保し、IMAGEHLP_SYMBOL64 構造体の必須パラメータを設定しておく必要がある。この関数を含め、すべての
DbgHelp
関数はシングルスレッドである。そのため複数のスレッドから同時に呼び出すと、予期しない動作やメモリ破壊を招く可能性が高い。これを避けるには、複数スレッドからの並行呼び出しをすべて同期する必要がある。この関数は
SymGetSymFromAddr 関数の後継である。詳細は Updated Platform Support
を参照のこと。SymGetSymFromAddr は Dbghelp.h で次のように定義されている。
（以下省略）

情報