The FindDebugInfoFile function locates a symbol file.
HANDLE FindDebugInfoFile(
| IN LPSTR FileName, | |
| IN LPSTR SymbolPath, | |
| OUT LPSTR DebugFilePath | |
| ); |
Parameters
FileName
The name of the .DBG file that is desired. This can contain a partial path.
SymbolPath
The path where symbol files are located. This can be multiple paths, with each separated by a semicolon (;).
DebugFilePath
The full path of the symbol file that is found.
Return Values
If the function succeeds, the return value is an open handle to the debug file.
If the function fails, then the return value is NULL. To retrieve extended error information, call GetLastError.
Remarks
The FindDebugInfoFile function is used to locate a symbol file. This function is provided so symbol files can be located in several different directories through a single function call. The SymbolPath parameter can contain multiple paths, with each separated by a semicolon (;). When multiple paths are specified, each directory tree is searched for the symbol file. When the file is located, the search stops. Thus, be sure to specify the SymbolPath with the paths in the correct order.