FindDebugInfoFileProc Callback Function

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. FindDebugInfoFileProc is a placeholder for the application-defined function name.

BOOL CALLBACK FindDebugInfoFileProc(
  [in]                 HANDLE FileHandle,
  [in]                 PTSTR FileName,
  [in]                 PVOID CallerData
);

Parameters

FileHandle

A handle to the symbol file.

FileName

The name of the symbol file.

CallerData

Optional user-defined data. This parameter can be NULL.

Return Value

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 SymGetModuleInfo64 function.

Requirements

Redistributable	Requires DbgHelp.dll 5.1 or later.
Header	Declared in DbgHelp.h.
Unicode	Implemented as PFIND_DEBUG_FILE_CALLBACKW (Unicode) and PFIND_DEBUG_FILE_CALLBACK (ANSI).

See Also

DbgHelp FunctionsFindDebugInfoFileEx
GetTimestampForLoadedLibrary
SymGetModuleInfo64

Send comments about this topic to Microsoft

Build date: 9/25/2007