FindDebugFileProc

The FindDebugFileProc function is an application-defined callback function used with the FindDebugInfoFileEx function. It verifies whether the symbol file located by FindDebugInfoFileEx is the correct symbol file.

The PFIND_DEBUG_FILE_CALLBACK type defines a pointer to this callback function. FindDebugFileProc is a placeholder for the application-defined function name.

BOOL FindDebugFileProc(
  HANDLE FileHandle,
  PSTR FileName,
  PVOID CallerData
);

Parameters

FileHandle

[in] Handle to the symbol file.

FileName

[in] Pointer to a null-terminated string that specifies the name of the symbol file.

CallerData

[in] User-defined data. This parameter can be NULL.

Return Values

If the symbol file is valid, return TRUE. Otherwise, return FALSE.

Remarks

One way to verify the symbol file is to compare its timestamp to the timestamp in the image. To retrieve the timestamp of the image, use the GetTimestampForLoadedLibrary function. To retrieve the timestamp of the symbol file, use the SymGetModuleInfo function.

Requirements

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

See Also

Debug Help Library Overview, DbgHelp Functions, FindDebugInfoFileEx, GetTimestampForLoadedLibrary, SymGetModuleInfo