IDebugEngine3::SetSymbolPath
デバッグ シンボルを検索する 1 つ以上のパスを設定します。
構文
int SetSymbolPath(
string szSymbolSearchPath,
string szSymbolCachePath,
enum_LOAD_SYMBOLS_FLAGS Flags
);
パラメーター
szSymbolSearchPath
[入力] 1 つ以上のシンボル検索パスを含む文字列。 詳細については、「解説」を参照してください。 null にすることはできません。
szSymbolCachePath
[入力] シンボルをキャッシュできるローカル パスを含む文字列。 null にすることはできません。
Flags
[入力] 使用されません。常に 0 に設定します。
戻り値
正常に終了した場合は、S_OK が返されます。それ以外の場合は、エラー コードが返されます。
解説
文字列 szSymbolSearchPath
は、シンボルを検索する 1 つ以上のパスをセミコロンで区切ったリストです。 これらのパスには、ローカル パス、UNC 形式のパス、または URL を指定できます。 これらのパスは、異なる種類を混在させることもできます。 パスが UNC (例: \\Symserver\Symbols) の場合、デバッグ エンジンでは、パスがシンボル サーバーのパスであるかどうかを判断する必要があります。また、そのサーバーからシンボルを読み込み、szSymbolCachePath
で指定されたパスにキャッシュできることが必要です。
シンボル パスには 1 つ以上のキャッシュ位置を含めることもできます。 キャッシュは優先度順にリストされ、最も優先度が高いキャッシュが先頭になり、* 記号で区切られます。 次に例を示します。
\\symbols\symbols;\\someotherserver\symbols;c:\symbols\httpsymbols*https://msdl.microsoft.com
LoadSymbols メソッドは、シンボルの実際の読み込みを実行します。