IWiaAppErrorHandler interface

The IWiaAppErrorHandler interface enables applications to display error windows (during data transfers) from which the user can choose whether to continue, cancel, or abort the transfer.

Members

The IWiaAppErrorHandler interface inherits from the IUnknown interface. IWiaAppErrorHandler also has these types of members:

• Methods

Methods

The IWiaAppErrorHandler interface has these methods.

Method	Description
GetWindow	Gets a handle to the dialog box that displays error messages and provides one or more buttons to continue, cancel, or abort the application.
ReportStatus	Handles device status and error messages during image data transfers and displays the messages to the user.

 

Remarks

The error handling, or callback, object that implements this interface is passed into IWiaTransfer::Download and IWiaTransfer::Upload.

This interface is not designed to handle errors encountered outside of image data transfers, for example, errors in getting or setting device properties or unreturned callbacks into a driver.

A driver error handler should implement IWiaErrorHandler, instead of IWiaAppErrorHandler.

The object that implements this interface should also implement IWiaTransferCallback.

If you want a driver error handler and default error handler to display error message windows, but you do not want to create a complete error handler for the application, implement this interface and also implement the IWiaAppErrorHandler::ReportStatus method to return WIA_STATUS_NOT_HANDLED.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Header	Wia.h
IDL	Wia.idl