SymSetSearchPath 関数 (dbghelp.h)

指定したプロセスの検索パスを設定します。

構文

BOOL IMAGEAPI SymSetSearchPath(
  [in]           HANDLE hProcess,
  [in, optional] PCSTR  SearchPath
);

[in] hProcess

SymInitialize 関数に最初に渡されたプロセスへのハンドル。

[in, optional] SearchPath

シンボル検索パス。文字列には、セミコロンで区切られた複数のパスを含めることができます。

関数が成功した場合、戻り値は TRUE になります。

関数が失敗した場合、戻り値は FALSE になります。拡張エラー情報を取得するには、 GetLastError を呼び出します。

ライブラリがアプリケーションで使用されている間、シンボル検索パスは何度でも変更できます。この変更は、シンボルハンドラーに対する今後のすべての呼び出しに影響します。

現在の検索パスを取得するには、 SymGetSearchPath 関数を呼び出します。

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

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