Método IWiaErrorHandler::ReportStatus

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

Sintaxis

HRESULT ReportStatus(
  [in] HWND     hwndParent,
  [in] IUnknown *punkItem,
  [in] HRESULT  hrStatus,
  [in] LONG     cbResLength,
  [in] BYTE     *pbData
);

Parámetros

hwndParent [in]

Tipo: HWND

HWND que es la ventana primaria de la ventana del mensaje.

punkItem [in]

Tipo: IUnknown*

Puntero a la interfaz IUnknown del elemento que se va a transferir. Este objeto implementa mínimamente IWiaItem2 e IWiaDataTransfer.

hrStatus [in]

Tipo: HRESULT

HRESULT que es el código de estado recibido por BandedDataCallback.

cbResLength [in]

Tipo: LONG

LONG que es el tamaño de los datos a los que hace referencia pbData.

pbData [in]

Tipo: BYTE*

Puntero al búfer de datos tal y como recibe BandedDataCallback.

Valor devuelto

Tipo: HRESULT

Devuelve hrStatus si no se puede recuperar el error. De lo contrario, devuelve uno de los valores siguientes.

Código devuelto	Descripción
S_OK	Se realizó la 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.
E_ABORT	El usuario eligió anular la transferencia en respuesta al cuadro de diálogo mostrado.

 

Comentarios

La adquisición de imágenes de Windows (WIA) 2.0 llama a IWiaErrorHandler::ReportStatus cuando el controlador envía un mensaje de IT_MSG_DEVICE_STATUS a BandedDataCallback. Este método controla el mensaje y muestra información al usuario sobre el estado o el error. Si el mensaje está relacionado con un error, el método permite al usuario elegir, si es posible, si desea intentar recuperarse del error y continuar la transferencia o anularla.

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á SEVERITY_SUCCESS, se debe permitir al usuario cancelar la transferencia.

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