SymSrvGetFileIndexString

SymSrvGetFileIndexString 関数 (dbghelp.h) は、指定された .pdb、.dbg、またはイメージファイルのインデックス文字列を取得する。

SymSrvGetFileIndexString hProcess, SrvPath, File, Index, Size, Flags

hProcess : [intptr] プロセスのハンドル。このハンドルは事前に SymInitialize 関数に渡されている必要がある。
SrvPath : [str] シンボルサーバーへのパス。
File : [str] ファイル名。
Index : [str] インデックス文字列を受け取るバッファへのポインタ。
Size : [int] Index バッファのサイズ（文字数）。
Flags : [int] このパラメータは将来の使用のために予約されている。

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

解説

SymSrvGetFileIndexString 関数 (dbghelp.h) は、指定された
.pdb、.dbg、またはイメージファイルのインデックス文字列を取得する。

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

[備考]

この関数は一般的な用途向けではない。シンボルサーバーストア内のファイル管理用ユーティリティを作成する場合、シンボルサーバーがファイルを検索する相対パスを予測するためにこの関数を使用できる。srctool.exe
はこの関数を使って実際にシンボルサーバーストアを構築している。この関数を含め、すべての DbgHelp
関数はシングルスレッドである。そのため複数のスレッドから同時に呼び出すと、予期しない動作やメモリ破壊を招く可能性が高い。これを避けるには、複数スレッドからの並行呼び出しをすべて同期する必要がある。この関数の
Unicode 版を呼び出すには DBGHELP_TRANSLATE_TCHAR を定義する。

情報