SymEnumSymbols

SymEnumSymbols 関数 (dbghelp.h) は、プロセス内のすべてのシンボルを列挙する。

SymEnumSymbols hProcess, BaseOfDll, Mask, EnumSymbolsCallback, UserContext

hProcess : [intptr] プロセスへのハンドル。このハンドルは事前に SymInitialize 関数に渡しておく必要がある。
BaseOfDll : [int64] モジュールのベースアドレス。この値が 0 で Mask に感嘆符 (!) が含まれている場合、関数はモジュールをまたいで検索する。この値が 0 で Mask に感嘆符が含まれていない場合、関数は SymSetContext 関数で確立されたスコープを使う。
Mask : [str] 列挙するシンボル名を示すワイルドカード文字列。テキストには任意でワイルドカード "*" および "?" を含められる。特定のモジュールまたはモジュール群を指定するには、モジュールを示すワイルドカード文字列の後に感嘆符を付けて先頭に置く。モジュールを指定した場合、BaseOfDll は無視される。
EnumSymbolsCallback : [int] シンボル情報を受け取る SymEnumSymbolsProc コールバック関数。
UserContext : [intptr] コールバック関数に渡されるユーザー定義の値、または NULL。このパラメーターは通常、コールバック関数にコンテキストを提供するデータ構造へのポインターを渡すために使用される。

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

解説

SymEnumSymbols 関数 (dbghelp.h) は、プロセス内のすべてのシンボルを列挙する。

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

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

情報