Share via


IDebugEngine3::SetSymbolPath

Sets the path or paths that are searched for debugging symbols.

HRESULT SetSymbolPath (
   LPOLESTR            szSymbolSearchPath,
   LPOLESTR            szSymbolCachePath,
   LOAD_SYMBOLS_FLAGS  Flags
);
int SetSymbolPath(
   string                    szSymbolSearchPath, 
   string                    szSymbolCachePath, 
   enum_LOAD_SYMBOLS_FLAGS   Flags
);

Parameters

Parameter

Description

szSymbolSearchPath

[in] String containing the symbol search path or paths. See "Remarks" for details. Cannot be null.

szSymbolCachePath

[in] String containing the local path where symbols can be cached. Cannot be null.

Flags

[in] Not used; always set to 0.

Return Value

If successful, returns S_OK; otherwise returns an error code.

Remarks

The string szSymbolSearchPath is a list of one or more paths, separated by semicolons, to search for symbols. These paths can be a local path, a UNC-style path, or a URL. These paths can also be a mix of different types. If the path is UNC (for example, \\Symserver\Symbols), then the debug engine should determine if the path is to a symbol server and should be able to load symbols from that server, caching them in the path specified by szSymbolCachePath.

The symbol path can also contain one or more cache locations. Caches are listed in priority order, with the highest priority cache first, and separated by * symbols. For example:

\\symbols\symbols;\\someotherserver\symbols;c:\symbols\httpsymbols*http://msdl.microsoft.com

The IDebugEngine3::LoadSymbols method performs the actual load of the symbols.

See Also

Reference

IDebugEngine3::LoadSymbols

IDebugEngine3