PIMAGEHLP_STATUS_ROUTINE

The PIMAGEHLP_STATUS_ROUTINE function is an application-defined callback function used with the BindImageEx function. The status routine is called during the process of the image binding.

The PIMAGEHLP_STATUS_ROUTINE type defines a pointer to this callback function. The application can define the function name.

typedef BOOL (CALLBACK *PIMAGEHLP_STATUS_ROUTINE)(
  IMAGEHLP_STATUS_REASON Reason,
  LPSTR ImageName,
  LPSTR DllName,
  ULONG Va,
  ULONG Parameter
);
 

Parameters

Reason

Specifies the current status of the bind operation. This parameter can be one of the following values.

Value	Meaning
BindOutOfMemory
BindRvaToVaFailed
BindNoRoomInImage
BindImportModuleFailed
BindImportProcedureFailed
BindImportModule
BindImportProcedure
BindForwarder
BindForwarderNOT
BindImageModified
BindExpandFileHeaders
BindImageComplete
BindMismatchedSymbols
BindSymbolsNotUpdated

ImageName

Pointer to a null-terminated string that specifies the name of the file to be bound. This value can be a filename, a partial path, or a full path.

DllName

Pointer to a null-terminated string that specifies the name of the DLL.

Va

Specifies the computed virtual address.

Parameter

Specifies additional status information. This value depends on the value of the Reason parameter.

Return Values

If the function succeeds, the return value is TRUE.

If the function fails, the return value is FALSE. To retrieve extended error information, call GetLastError.

See Also

PE Image Helper (ImageHlp) Overview, ImageHlp Image Modification Functions, BindImageEx