Поделиться через


Интерфейс IWiaAppErrorHandler

Интерфейс IWiaAppErrorHandler позволяет приложениям отображать окна ошибок (во время передачи данных), из которых пользователь может выбрать, следует ли продолжить, отменить или прервать передачу.

Элементы

Интерфейс IWiaAppErrorHandler наследуется от интерфейса IUnknown . IWiaAppErrorHandler также имеет следующие типы элементов:

Методы

Интерфейс IWiaAppErrorHandler имеет следующие методы.

Метод Описание
GetWindow Возвращает дескриптор диалогового окна, в котором отображаются сообщения об ошибках и предоставляются одна или несколько кнопок для продолжения, отмены или прерывания работы приложения.
ReportStatus Обрабатывает состояние устройства и сообщения об ошибках во время передачи данных изображения и отображает сообщения для пользователя.

 

Комментарии

Объект обработки ошибок или обратного вызова, реализующий этот интерфейс, передается в IWiaTransfer::D ownload и IWiaTransfer::Upload.

Этот интерфейс не предназначен для обработки ошибок, возникающих за пределами передачи данных изображений, например ошибок при получении или настройке свойств устройства или необработанных обратных вызовов в драйвере.

Обработчик ошибок драйвера должен реализовывать IWiaErrorHandler вместо IWiaAppErrorHandler.

Объект, реализующий этот интерфейс, также должен реализовывать IWiaTransferCallback.

Если требуется, чтобы обработчик ошибок драйвера и обработчик ошибок по умолчанию отображали окна сообщений об ошибках, но не хотите создавать полный обработчик ошибок для приложения, реализуйте этот интерфейс, а также реализуйте метод IWiaAppErrorHandler::ReportStatus для возврата WIA_STATUS_NOT_HANDLED.

Требования

Требование Значение
Минимальная версия клиента
Windows Vista [только классические приложения]
Минимальная версия сервера
Windows Server 2008 [только классические приложения]
Заголовок
Wia.h
IDL
Wia.idl