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 usa. Debe establecerse como cero.
[in] hwndParent
Identificador proporcionado por el autor de la llamada de la ventana que se debe usar como ventana primaria para los cuadros de diálogo. Si se establece en NULL, no se deben mostrar cuadros de diálogo.
[in] pWiaItem2
Puntero al elementoIWiaItem2 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, al que hace referencia el puntero pbData .
Valor devuelto
Devuelve un código de error COM estándar si no se puede recuperar el error 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 ha realizado ninguna acción para controlar el estado del error o informe al usuario. |
Comentarios
El objeto de devolución de llamada del proxy COM llama al método WiaErrorHandler::ReportStatus cuando el controlador envía un mensaje de 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 posibilidad de cancelar la transferencia si HRESULT es SEVERITY_SUCCESS.
Un controlador que implemente 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 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 está S_OK, la transferencia de datos se ha reanudado y no hay ningún retraso o error actualmente en vigor.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | wia_lh.h (incluya Wia_lh.h) |