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

The IWiaAppErrorHandler interface has these methods.

MethodDescription
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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Wia.h

IDL

Wia.idl

 

 

Community Additions

ADD
Show:
© 2014 Microsoft