PFIND_DEBUG_FILE_CALLBACKW callback function (dbghelp.h)
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 and PFIND_DEBUG_FILE_CALLBACKW types define a pointer to this callback function. FindDebugInfoFileProc is a placeholder for the application-defined function name.
Syntax
PFIND_DEBUG_FILE_CALLBACKW PfindDebugFileCallbackw;
BOOL PfindDebugFileCallbackw(
[in] HANDLE FileHandle,
[in] PCWSTR FileName,
[in] PVOID CallerData
)
{...}
Parameters
[in] FileHandle
A handle to the symbol file.
[in] FileName
The name of the symbol file.
[in] 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.
Note
The dbghelp.h header defines PFIND_DEBUG_FILE_CALLBACK as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that is not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | dbghelp.h |
| Redistributable | DbgHelp.dll 5.1 or later |