SymSetHomeDirectory 関数 (dbghelp.h)

Dbghelp によって使用されるホームディレクトリを設定します。

構文

PCHAR IMAGEAPI SymSetHomeDirectory(
  [in]           HANDLE hProcess,
  [in, optional] PCSTR  dir
);

[in] hProcess

プロセスへのハンドル。このハンドルは、 SymInitialize 関数に以前に渡されている必要があります。

[in, optional] dir

ホームディレクトリ。このディレクトリは書き込み可能である必要があります。それ以外の場合、ホームディレクトリは CSIDL_COMMON_APPDATA で指定された共通アプリケーションディレクトリです。このパラメーターが NULL の場合、関数は既定のディレクトリを使用します。

関数が成功した場合、戻り値は dir パラメーターへのポインターです。

関数が失敗した場合は、返される値は NULL です。拡張エラー情報を取得するには、 GetLastError を呼び出します。

既定のホームディレクトリは、Dbghelp.dll が存在するディレクトリです。 Dbghelp は、既定のダウンストリームストアディレクトリ (ホームディレクトリの sym サブディレクトリ) など、他のディレクトリの基礎としてこのディレクトリを使用します。

既定のシンボルストアとソースサーバーキャッシュの場所に使用されるホームディレクトリは、DBGHELP_HOMEDIR環境変数に格納されます。

この関数など、すべての DbgHelp 関数はシングルスレッドです。そのため、複数のスレッドからこの関数を呼び出すと、予期しない動作やメモリ破損が発生する可能性があります。これを回避するには、複数のスレッドからのすべての同時呼び出しをこの関数に同期する必要があります。

この関数の Unicode バージョンを呼び出すには、DBGHELP_TRANSLATE_TCHARを定義します。