SymSrvStoreSupplement

SymSrvStoreSupplement 関数 (dbghelp.h) は、シンボルストアの指定された補助領域にファイルを保存する。

SymSrvStoreSupplement hProcess, SrvPath, Node, File, Flags

hProcess : [intptr] プロセスのハンドル。このハンドルは事前に SymInitialize 関数に渡されている必要がある。
SrvPath : [str] シンボルストアへのパス。
Node : [str] 補助ファイルに関連付けられたシンボルファイル。
File : [str] ファイル名。
Flags : [int] このパラメータが SYMSTOREOPT_COMPRESS の場合、ファイルはシンボルストア内で圧縮される。現在のところ、それ以外にサポートされる値はない。

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

解説

SymSrvStoreSupplement 関数 (dbghelp.h) は、シンボルストアの指定された補助領域にファイルを保存する。

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

[備考]
この関数の重要な用途の 1 つは差分ファイルの保存である。詳細は SymSrvDeltaName
を参照のこと。この関数は他の関数から再利用される可能性があるバッファへのポインタを返すため、返されたデータはただちに別のバッファへコピーすること。シンボルサーバーは同じ拡張子を持つ補助ファイルを共通のディレクトリに保存する。たとえば
Sup1.xml は次のディレクトリに保存される:
SymPath\supplement\Node\xml。ストアの管理者は、ストアのルートに Supplement
という名前の読み取り専用ファイルを作成することで、ユーザーによる補助ファイルの書き込みを防止できる。あるいは、supplement
ディレクトリを作成し、ACL でアクセスを制御してもよい。この関数を含め、すべての DbgHelp
関数はシングルスレッドである。そのため複数のスレッドから同時に呼び出すと、予期しない動作やメモリ破壊を招く可能性が高い。これを避けるには、複数スレッドからの並行呼び出しをすべて同期する必要がある。この関数の
Unicode 版を呼び出すには DBGHELP_TRANSLATE_TCHAR を定義する。

情報