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 IDebugEngine3::LoadSymbols method performs the actual load of the symbols.

See Also

Reference

IDebugEngine3::LoadSymbols

IDebugEngine3