SymEnumSymbolsForAddr

SymEnumSymbolsForAddr 関数 (dbghelp.h) は、指定したアドレスに対応するシンボルを列挙する。

SymEnumSymbolsForAddr hProcess, Address, EnumSymbolsCallback, UserContext

hProcess : [intptr] プロセスへのハンドル。このハンドルは事前に SymInitialize 関数に渡しておく必要がある。
Address : [int64] シンボルを検索する対象アドレス。アドレスはシンボルの境界上にある必要はない。アドレスがシンボルの開始以降、終端 (シンボル開始 + シンボルサイズ) より前にある場合、関数はそのシンボルを検出する。
EnumSymbolsCallback : [int] アプリケーション定義のコールバック関数。この関数は Address で見つかったシンボルごとに呼び出される。詳細は SymEnumSymbolsProc を参照。
UserContext : [intptr] 省略可能なユーザー定義データ。この値はコールバック関数に渡される。

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

解説

SymEnumSymbolsForAddr 関数 (dbghelp.h) は、指定したアドレスに対応するシンボルを列挙する。

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

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

情報