SymSetHomeDirectory

SymSetHomeDirectory 関数 (dbghelp.h) は、Dbghelp が使用するホームディレクトリを設定する。

SymSetHomeDirectory hProcess, dir

hProcess : [intptr] プロセスのハンドル。このハンドルは事前に SymInitialize 関数に渡されている必要がある。
dir : [str] ホームディレクトリ。このディレクトリは書き込み可能でなければならない。書き込めない場合、ホームディレクトリには [CSIDL_COMMON_APPDATA](/windows/win32/shell/csidl) で指定される共通アプリケーションディレクトリが使用される。このパラメータが NULL の場合、関数は既定のディレクトリを使用する。

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

解説

SymSetHomeDirectory 関数 (dbghelp.h) は、Dbghelp が使用するホームディレクトリを設定する。

[戻り値]
関数が成功した場合、戻り値は dir パラメータへのポインタである。関数が失敗した場合、戻り値は NULL
である。拡張エラー情報を取得するには、GetLastError を呼び出す。

[備考]
既定のホームディレクトリは Dbghelp.dll が存在するディレクトリである。Dbghelp
はこのディレクトリを他のディレクトリ（既定のダウンストリームストアディレクトリ、すなわちホームディレクトリ直下の sym
サブディレクトリなど）の基点として使用する。既定のシンボルストアおよびソースサーバーキャッシュの場所として使用されるホームディレクトリは、DBGHELP_HOMEDIR
環境変数に保存される。この関数を含め、すべての DbgHelp
関数はシングルスレッドである。そのため複数のスレッドから同時に呼び出すと、予期しない動作やメモリ破壊を招く可能性が高い。これを避けるには、複数スレッドからの並行呼び出しをすべて同期する必要がある。この関数の
Unicode 版を呼び出すには DBGHELP_TRANSLATE_TCHAR を定義する。

情報