Metodo IWiaAppErrorHandler::ReportStatus

Articolo
06/12/2023

Gestisce lo stato del dispositivo e i messaggi di errore durante i trasferimenti di dati dell'immagine e visualizza i messaggi all'utente.

Sintassi

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

Parametri

lFlags [in]

Tipo: LONG

Non usato. Impostare su 0.

pWiaItem2 [in]

Tipo: IWiaItem2*

Puntatore all'elemento da trasferire.

hrStatus [in]

Tipo: HRESULT

Codice di stato del dispositivo.

lPercentComplete [in]

Tipo: LONG

Percentuale completata dell'operazione corrente.

Valore restituito

Tipo: HRESULT

Restituisce hrStatus se il ripristino dall'errore non è possibile. In caso contrario, restituisce uno dei valori seguenti.

Codice restituito	Descrizione
S_OK	Se hrStatus è un errore, l'azione appropriata è stata eseguita per correggere l'errore e il trasferimento può continuare. Se hrStatus è informativo, l'utente è stato informato con una finestra di dialogo senza modalità e ha scelto di non annullare il trasferimento.
S_FALSE	L'utente ha annullato il trasferimento dalla finestra di dialogo senza modalità del gestore degli errori. Questo valore può essere restituito in qualsiasi momento indipendentemente dal valore hrStatus .
WIA_STATUS_NOT_HANDLED	Nessuna azione è stata eseguita; ovvero, nessuna finestra di dialogo è stata presentata all'utente. Verrà richiamato il gestore di errori successivo. L'ordine dei gestori degli errori è: applicazione, driver e impostazione predefinita del sistema.

Commenti

Il parametro lPercentComplete consente a un gestore di errori di visualizzare lo stato di avanzamento. Ad esempio, un driver potrebbe fornire una stima della durata del "riscaldamento". Il parametro lPercentComplete passato in IWiaAppErrorHandler::ReportStatus è lo stesso valore dell'elemento lPercentComplete impostato dal driver nella struttura WiaTransferParams.

Un gestore degli errori può usare le macro SUCCESSED e FAILED per scoprire se hrStatus ha SEVERITY_ERROR o SEVERITY_SUCCESS.

Se hrStatus è SEVERITY_SUCCESS, l'utente deve essere autorizzato ad annullare il trasferimento.

Se hrStatus è SEVERITY_ERROR, il gestore degli errori deve visualizzare una finestra di dialogo modale di proprietà della finestra padre dell'applicazione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	Wia.h
IDL	Wia.idl
Libreria	Wiaguid.lib

Condividi tramite