Export (0) Print
Expand All
Expand Minimize
0 out of 1 rated this helpful - Rate this topic

SymFindFileInPath function

Locates a symbol file or executable image.

Syntax


BOOL WINAPI SymFindFileInPath(
  _In_      HANDLE hProcess,
  _In_opt_  PCTSTR SearchPath,
  _In_      PCTSTR FileName,
  _In_opt_  PVOID id,
  _In_      DWORD two,
  _In_      DWORD three,
  _In_      DWORD flags,
  _Out_     PTSTR FilePath,
  _In_opt_  PFINDFILEINPATHCALLBACK callback,
  _In_opt_  PVOID context
);

Parameters

hProcess [in]

A handle to the process that was originally passed to the SymInitialize function.

SearchPath [in, optional]

The search path. This can be multiple paths separated by semicolons. It can include both directories and symbol servers. If this parameter is NULL, the function uses the search path set using the SymSetSearchPath or SymInitialize function.

FileName [in]

The name of the file. You can specify a path; however, only the file name is used.

id [in, optional]

The first of three identifying parameters (see Remarks).

two [in]

The second of three identifying parameters (see Remarks).

three [in]

The third of three identifying parameters (see Remarks).

flags [in]

The format of the id parameter. This parameter can be one of the following values.

ValueMeaning
SSRVOPT_DWORD
0x0002

The id parameter is a DWORD.

SSRVOPT_DWORDPTR
0x0004

The id parameter is a pointer to a DWORD.

SSRVOPT_GUIDPTR
0x0008

The id parameter is a pointer to a GUID.

 

FilePath [out]

A pointer to a buffer that receives the fully qualified path to the symbol file. This buffer must be at least MAX_PATH characters.

callback [in, optional]

A SymFindFileInPathProc callback function.

context [in, optional]

A user-defined value or NULL. This value is simply passed to the callback function. This parameter is typically used by an application to pass a pointer to a data structure that provides some context for the callback function.

Return value

If the server locates a valid symbol file, it returns TRUE; otherwise, it returns FALSE and GetLastError returns a value that indicates why the symbol file was not returned.

Remarks

The identifying parameters are filled in as follows:

  • If DbgHelp is looking for a .pdb file, the id parameter specifies the PDB signature as found in the codeview debug directory of the original image. Parameter two specifies the PDB age. Parameter three is unused and set to zero.

  • If DbgHelp is looking for any other type of image, such as an executable file or .dbg file, the id parameter specifies the TimeDateStamp of the original image as found in its PE header. Parameter two specifies the SizeOfImage field, also extracted from the PE header. Parameter three is unused and set to zero.

All of these values can be obtained by calling SymSrvGetFileIndexInfo.

When searching a directory, this function does not verify that the symbol identifiers match by default. To ensure the matching symbol files are located, call the SymSetOptions function with SYMOPT_EXACT_SYMBOLS.

All DbgHelp functions, such as this one, are single threaded. Therefore, calls from more than one thread to this function will likely result in unexpected behavior or memory corruption. To avoid this, you must synchronize all concurrent calls from more than one thread to this function.

To call the Unicode version of this function, define DBGHELP_TRANSLATE_TCHAR.

Requirements

Redistributable

DbgHelp.dll 5.1 or later

Header

DbgHelp.h

Library

DbgHelp.lib

DLL

DbgHelp.dll

Unicode and ANSI names

SymFindFileInPathW (Unicode) and SymFindFileInPath (ANSI)

See also

DbgHelp Functions
SymFindFileInPathProc
SymInitialize
SymSetSearchPath
SymSrvGetFileIndexInfo

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.