SymSetSearchPath

SymSetSearchPath 関数 (dbghelp.h) は、指定されたプロセスの検索パスを設定する。

SymSetSearchPath hProcess, SearchPathA

hProcess : [intptr] もともと SymInitialize 関数に渡したプロセスのハンドル。
SearchPathA : [str] 

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

解説

SymSetSearchPath 関数 (dbghelp.h) は、指定されたプロセスの検索パスを設定する。

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

[備考]

シンボル検索パスはアプリケーションがライブラリを使用している間、何度でも変更できる。変更は以降のシンボルハンドラ呼び出しすべてに影響する。現在の検索パスを取得するには、SymGetSearchPath
関数を呼び出す。この関数を含め、すべての DbgHelp
関数はシングルスレッドである。そのため複数のスレッドから同時に呼び出すと、予期しない動作やメモリ破壊を招く可能性が高い。これを避けるには、複数スレッドからの並行呼び出しをすべて同期する必要がある。この関数の
Unicode 版を呼び出すには DBGHELP_TRANSLATE_TCHAR を定義する。

情報