FindExecutableImageProc Callback Function

Debug Help Library

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

© 2007 Microsoft Corporation. All rights reserved.