SymGetSearchPath

The SymGetSearchPath function retrieves the search path for the specified process.

BOOL SymGetSearchPath(
  IN HANDLE hProcess,    
  OUT LPSTR SearchPath,  
  IN DWORD SearchPathLength  
);
 

Parameters

hProcess

Handle to the process that was originally passed to the SymInitialize function.

SearchPath

Pointer to the buffer that receives the search path.

SearchPathLength

Specifies the length in bytes of the SearchPath buffer.

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 SymGetSearchPath function copies the search path for the specified process into the SearchPath buffer. If the function fails, the contents of the buffer are undefined.

To specify a search path for the process, use the SymSetSearchPath function.

QuickInfo

  Windows NT: Requires version 4.0 or later.
  Windows: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in imagehlp.h.
  Import Library: Use imagehlp.lib.

See Also

PE Image Helper (ImageHlp) Overview, Symbol Handler, SymInitialize, SymSetSearchPath