PFIND_EXE_FILE_CALLBACKW callback function (dbghelp.h)
An application-defined callback function used with the FindExecutableImageEx function. It verifies whether the executable file found by FindExecutableImageEx is the correct executable file.
The PFIND_EXE_FILE_CALLBACK and PFIND_EXE_FILE_CALLBACKW types define a pointer to this callback function. FindExecutableImageProc is a placeholder for the application-defined function name.
Syntax
PFIND_EXE_FILE_CALLBACKW PfindExeFileCallbackw;
BOOL PfindExeFileCallbackw(
[in] HANDLE FileHandle,
[in] PCWSTR FileName,
[in] PVOID CallerData
)
{...}
Parameters
[in] FileHandle
A handle to the executable file.
[in] FileName
The name of the executable file.
[in] CallerData
Optional user-defined data. This parameter can be NULL.
Return value
If the executable file is valid, return TRUE. Otherwise, return FALSE.
Remarks
Note
The dbghelp.h header defines PFIND_EXE_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 |