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

Метод IWiaAppErrorHandler::ReportStatus

  • Статья

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

Синтаксис

HRESULT ReportStatus(
  [in] LONG      lFlags,
  [in] IWiaItem2 *pWiaItem2,
  [in] HRESULT   hrStatus,
  [in] LONG      lPercentComplete
);

Параметры

lFlags [in]

Тип: LONG

Не используется. Задайте значение 0.

pWiaItem2 [in]

Тип: IWiaItem2*

Указатель на передаваемый элемент.

hrStatus [in]

Тип: HRESULT

Код состояния устройства.

lPercentComplete [in]

Тип: LONG

Процент завершения текущей операции.

Возвращаемое значение

Тип: HRESULT

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

Код возврата Описание
S_OK
 Если hrStatus является ошибкой, было выполнено соответствующее действие, чтобы исправить ошибку, и передача может продолжаться. Если hrStatus является информационным, пользователь был проинформирован с помощью немодерного диалогового окна и решил не отменять передачу.
S_FALSE
 Пользователь отменил передачу из нережимного диалогового окна обработчика ошибок. Это значение может быть возвращено в любой момент независимо от того, что такое hrStatus .
WIA_STATUS_NOT_HANDLED
 Никаких действий предпринять не было; то есть диалоговое окно для пользователя не было представлено. Будет вызван следующий обработчик ошибок. Порядок обработчиков ошибок: приложение, драйвер и система по умолчанию.

 

Комментарии

Параметр lPercentComplete позволяет окну обработчика ошибок отображать ход выполнения. Например, драйвер может предоставить оценку того, сколько времени занимает "прогревание". Параметр lPercentComplete, передаваемый в IWiaAppErrorHandler::ReportStatus , совпадает с значением lPercentComplete , которое драйвер задает в структуре WiaTransferParams .

Обработчик ошибок может использовать макросы SUCCEEDED и FAILED, чтобы узнать, имеет ли hrStatus SEVERITY_ERROR или SEVERITY_SUCCESS.

Если параметр hrStatus SEVERITY_SUCCESS, пользователю должно быть разрешено отменить передачу.

Если параметр hrStatus SEVERITY_ERROR, обработчик ошибок должен отображать модальное диалоговое окно, принадлежащее родительскому окну приложения.

Требования

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