PFIND_EXE_FILE_CALLBACKW callback function (dbghelp.h)

  • Article

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 which 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 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

See also

DbgHelp Functions

FindExecutableImageEx