Metodo IWiaErrorHandler::ReportStatus

Articolo
06/12/2023

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

Sintassi

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

Parametri

hwndParent [in]

Tipo: HWND

HWND che rappresenta la finestra padre per la finestra del messaggio.

punkItem [in]

Tipo: IUnknown*

Puntatore all'interfaccia IUnknown dell'elemento da trasferire. Questo oggetto implementa minimamente IWiaItem2 e IWiaDataTransfer.

hrStatus [in]

Tipo: HRESULT

HRESULT che è il codice di stato ricevuto da BandedDataCallback.

cbResLength [in]

Tipo: LONG

LONG che rappresenta le dimensioni dei dati a cui fa riferimento pbData.

pbData [in]

Tipo: BYTE*

Puntatore al buffer di dati ricevuto da BandedDataCallback.

Valore restituito

Tipo: HRESULT

Restituisce hrStatus se l'errore non può essere recuperato. In caso contrario, restituisce uno dei valori seguenti.

Codice restituito	Descrizione
S_OK	L'azione appropriata è stata eseguita per correggere l'errore e il trasferimento può continuare.
S_FALSE	Non è stata eseguita alcuna azione per gestire l'errore o segnalare lo stato all'utente.
E_ABORT	L'utente ha scelto di interrompere il trasferimento in risposta alla finestra di dialogo visualizzata.

Commenti

Windows Image Acquisition (WIA) 2.0 chiama IWiaErrorHandler::ReportStatus quando il driver invia un messaggio di IT_MSG_DEVICE_STATUS a BandedDataCallback. Questo metodo gestisce il messaggio e visualizza le informazioni all'utente sullo stato o sull'errore. Se il messaggio riguarda un errore, il metodo consente all'utente di scegliere, se possibile, se tentare di eseguire il ripristino dall'errore e continuare il trasferimento o l'interruzione.

hrStatus è impostato su WIA_STATUS_TRANSFER_BEGIN per informare che il gestore ha avviato un trasferimento. È impostato su WIA_STATUS_TRANSFER_END al termine del trasferimento.

Se hrStatus è SEVERITY_SUCCESS, l'utente deve poter annullare il trasferimento.

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