FindExecutableImageProc Callback Function

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 type defines a pointer to this callback function. FindExecutableImageProc is a placeholder for the application-defined function name.

BOOL CALLBACK FindExecutableImageProc(
  [in]                 HANDLE FileHandle,
  [in]                 PCTSTR FileName,
  [in]                 PVOID CallerData
);

Parameters

FileHandle

A handle to the executable file.

FileName

The name of the executable file.

CallerData

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

Return Value

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

Requirements

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

See Also

DbgHelp FunctionsFindExecutableImageEx

Send comments about this topic to Microsoft

Build date: 9/25/2007