Platform SDK: Debugging and Error Handling

SymSetSearchPath

The SymSetSearchPath function sets the search path for the specified process.

BOOL SymSetSearchPath(
  HANDLE hProcess,  
  PSTR SearchPath  
);

Parameters

hProcess
[in] Handle to the process that was originally passed to the SymInitialize function.
SearchPath
[in] Specifies the symbol search path. The string can contain multiple paths separated by semicolons.

Return Values

If the function succeeds, the return value is TRUE.

If the function fails, the return value is FALSE. To retrieve extended error information, call GetLastError.

Remarks

The symbol search path can be changed any number of times while the library is in use by an application. The change affects all future calls to the symbol handler.

To get the current search path, call the SymGetSearchPath function.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 or later.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in Dbghelp.h.
  Library: Use Dbghelp.lib.

See Also

Debug Help Library Overview, DbgHelp Functions, SymGetSearchPath, SymInitialize