SymSrvGetSupplement

SymSrvGetSupplement 関数 (dbghelp.h) は、シンボルストアの補助領域から指定されたファイルを取得する。

SymSrvGetSupplement hProcess, SymPath, Node, File

hProcess : [intptr] プロセスのハンドル。このハンドルは事前に SymInitialize 関数に渡されている必要がある。
SymPath : [str] シンボルパス。関数はシンボルストアの標準構文で記述されたシンボルストアのみを使用する。その他のパスは無視される。このパラメータが NULL の場合、関数は SymInitialize または SymSetSearchPath 関数で設定されたシンボルパスを使用する。
Node : [str] 補助ファイルに関連付けられたシンボルファイル。
File : [str] ファイル名。

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

解説

SymSrvGetSupplement 関数 (dbghelp.h) は、シンボルストアの補助領域から指定されたファイルを取得する。

[戻り値]
関数が成功した場合、戻り値は補助ファイルの完全修飾パスである。
関数が失敗した場合、戻り値は NULL である。拡張エラー情報を取得するには、GetLastError を呼び出す。

[備考]
補助ファイルの詳細については、SymSrvStoreSupplement
を参照のこと。この関数は他の関数から再利用される可能性があるバッファへのポインタを返すため、返されたデータはただちに別のバッファへコピーすること。この関数を含め、すべての
DbgHelp
関数はシングルスレッドである。そのため複数のスレッドから同時に呼び出すと、予期しない動作やメモリ破壊を招く可能性が高い。これを避けるには、複数スレッドからの並行呼び出しをすべて同期する必要がある。この関数の
Unicode 版を呼び出すには DBGHELP_TRANSLATE_TCHAR を定義する。

情報