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.
| 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 |
|
| IDL |
|