Método IWiaErrorHandler::ReportStatus (wia_lh.h)
El método ReportStatus muestra información sobre un error o estado durante una transferencia. En algunos casos, este método permite al usuario recuperarse de un error.
Sintaxis
HRESULT ReportStatus(
[in] LONG lFlags,
[in] HWND hwndParent,
[in] IWiaItem2 *pWiaItem2,
[in] HRESULT hrStatus,
[in] LONG lPercentComplete
);
Parámetros
[in] lFlags
Actualmente no se está usando. Debe establecerse en cero.
[in] hwndParent
Identificador proporcionado por el autor de la llamada de la ventana que se debe usar como ventana principal para los cuadros de diálogo. Si se establece en NULL, no se deben mostrar cuadros de diálogo.
[in] pWiaItem2
Puntero alIWiaItem2 elemento que se va a transferir.
[in] hrStatus
Variable HRESULT que contiene el código de estado recibido por el método de transferencia WIA, por ejemplo, el método IWiaDataCallback::BandedDataCallback.
[in] lPercentComplete
Tamaño de los datos, en bytes, el puntero pbData hace referencia.
Valor devuelto
Devuelve un código de error COM estándar si el error no se puede recuperar o si el usuario decide anular la transferencia en respuesta al cuadro de diálogo mostrado. Hay información adicional sobre los valores devueltos en la sección comentarios. De lo contrario, este método devuelve uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
| S_OK | Se realizó una acción adecuada para corregir el error y la transferencia puede continuar. |
| S_FALSE | No se realizó ninguna acción para controlar el estado del error o informe al usuario. |
Observaciones
El objeto de devolución de llamada del proxy COM llama al método WiaErrorHandler::ReportStat us cuando el controlador envía un mensaje IT_MSG_DEVICE_STATUS al método IWiaDataCallback::BandedDataCallback. El cuadro de diálogo que muestra este método proporciona al usuario información de error o estado y, posiblemente, ofrece la oportunidad de recuperarse del error y continuar la transferencia. La interfaz de usuario solo debe proporcionar un cuadro de diálogo informativo y una oportunidad para cancelar la transferencia si HRESULT es SEVERITY_SUCCESS.
Un controlador que implementa este método debe mostrar un cuadro de diálogo modal, propiedad de hwndParent, en respuesta a un valor de hrStatus para el que FAILED(hrStatus) se evalúa como TRUE. Si FAILED(hrStatus) se evalúa como FALSE, el valor de hrStatus representa un retraso nofatal y el cuadro de diálogo que se muestra debe ser modeles. El cuadro de diálogo debe quitarse cuando cambie el estado de la transferencia. Un controlador de errores debe devolver S_FALSE para los valores desconocidos de hrStatus.
El parámetro hrStatus se establece en WIA_STATUS_TRANSFER_BEGIN para informar al controlador de que se ha iniciado una transferencia. Se establece en WIA_STATUS_TRANSFER_END cuando se completa la transferencia.
Si hrStatus es S_OK, la transferencia de datos se ha reanudado y actualmente no hay ningún retraso o error.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | wia_lh.h (incluya Wia_lh.h) |