SymSrvDeltaName

SymSrvDeltaName 関数 (dbghelp.h) は、同一のシンボル／イメージの 2 つのバージョン間の関係を表すファイルの名前を生成する。

SymSrvDeltaName hProcess, SymPath, Type, File1, File2

hProcess : [intptr] プロセスのハンドル。このハンドルは事前に SymInitialize 関数に渡されている必要がある。
SymPath : [str] シンボルパス。関数はシンボルストアの標準構文で記述されたシンボルストアのみを使用する。その他のパスは無視される。このパラメータが NULL の場合、関数は SymInitialize または SymSetSearchPath 関数で設定されたシンボルパスを使用する。
Type : [str] 生成されるファイル名の拡張子。
File1 : [str] シンボルまたはイメージファイルの第 1 バージョンのパス。
File2 : [str] シンボルまたはイメージファイルの第 2 バージョンのパス。

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

解説

SymSrvDeltaName 関数 (dbghelp.h) は、同一のシンボル／イメージの 2
つのバージョン間の関係を表すファイルの名前を生成する。

[戻り値]
関数が成功した場合、戻り値は生成されたファイル名である。
関数が失敗した場合、戻り値は NULL である。拡張エラー情報を取得するには、GetLastError を呼び出す。

[備考]
この関数は指定された 2
つのファイルを開き、ヘッダからインデックス情報を読み取ってシンボルサーバーに渡し、ファイル名を生成させる。Type パラメータに
"xml" を指定すると、名前は File1 のインデックスに続いてダッシュ、さらに File2 のインデックス、.xml
拡張子の順となる。例: 3F3D5C755000-3F3D647621000.xml
この関数は他の関数から再利用される可能性があるバッファへのポインタを返すため、返されたデータはただちに別のバッファへコピーすること。この関数を含め、すべての
DbgHelp
関数はシングルスレッドである。そのため複数のスレッドから同時に呼び出すと、予期しない動作やメモリ破壊を招く可能性が高い。これを避けるには、複数スレッドからの並行呼び出しをすべて同期する必要がある。この関数の
Unicode 版を呼び出すには DBGHELP_TRANSLATE_TCHAR を定義する。

情報