Método IWiaAppErrorHandler::ReportStatus

Controla el estado del dispositivo y los mensajes de error durante las transferencias de datos de imagen y muestra los mensajes al usuario.

Sintaxis

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

Parámetros

lFlags [in]

Tipo: LONG

No se utiliza. Establecer en 0.

pWiaItem2 [in]

Tipo: IWiaItem2*

Puntero al elemento que se va a transferir.

hrStatus [in]

Tipo: HRESULT

Código de estado del dispositivo.

lPercentComplete [in]

Tipo: LONG

Porcentaje completado de la operación actual.

Valor devuelto

Tipo: HRESULT

Devuelve hrStatus si la recuperación del error no es posible. De lo contrario, devuelve uno de los valores siguientes.

Código devuelto	Descripción
S_OK	Si hrStatus es un error, se realizó la acción adecuada para corregir el error y la transferencia puede continuar. Si hrStatus es informativo, el usuario se informó con un cuadro de diálogo modeless y eligió no cancelar la transferencia.
S_FALSE	El usuario canceló la transferencia desde el cuadro de diálogo modeless del controlador de errores. Este valor se puede devolver en cualquier momento independientemente de lo que sea hrStatus .
WIA_STATUS_NOT_HANDLED	No se realizó ninguna acción; es decir, no se ha presentado ningún cuadro de diálogo al usuario. Se invocará el siguiente controlador de errores. El orden de los controladores de errores es: aplicación, controlador y valor predeterminado del sistema.

 

Comentarios

El parámetro lPercentComplete permite que una ventana del controlador de errores muestre el progreso. Por ejemplo, un controlador podría proporcionar una estimación del tiempo que tarda "calentamiento". El parámetro lPercentComplete pasado a IWiaAppErrorHandler::ReportStatus es el mismo valor que el lPercentComplete que el controlador establece en la estructura WiaTransferParams .

Un controlador de errores puede usar las macros SUCCEEDED y FAILED para averiguar si hrStatus tiene SEVERITY_ERROR o SEVERITY_SUCCESS.

Si hrStatus está SEVERITY_SUCCESS, se debe permitir al usuario cancelar la transferencia.

Si hrStatus está SEVERITY_ERROR, el controlador de errores debe mostrar un cuadro de diálogo modal propiedad de la ventana primaria de la aplicación.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	Wia.h
IDL	Wia.idl
Biblioteca	Wiaguid.lib