IWiaErrorHandler::ReportStatus-Methode

Artikel
06/13/2023

Verarbeitet status und Fehlermeldungen während der Bilddatenübertragung und zeigt sie dem Benutzer an.

Syntax

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

Parameter

hwndParent [in]

Typ: HWND

HWND , das das übergeordnete Fenster für das Meldungsfenster ist.

punkItem [in]

Typ: IUnknown*

Zeiger auf die IUnknown-Schnittstelle des zu übertragenden Elements. Dieses Objekt implementiert mindestens IWiaItem2 und IWiaDataTransfer.

hrStatus [in]

Typ: HRESULT

HRESULT, bei dem es sich um den status Code handelt, der von BandedDataCallback empfangen wird.

cbResLength [in]

Typ: LONG

LONG , das die Größe der Daten ist, auf die von pbData verwiesen wird.

pbData [in]

Typ: BYTE*

Zeiger auf den Datenpuffer, der von BandedDataCallback empfangen wird.

Rückgabewert

Typ: HRESULT

Gibt hrStatus zurück, wenn der Fehler nicht wiederhergestellt werden kann. Andernfalls wird einer der folgenden Werte zurückgegeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die entsprechende Aktion wurde ergriffen, um den Fehler zu beheben, und die Übertragung kann fortgesetzt werden.
S_FALSE	Es wurde keine Aktion ausgeführt, um den Fehler zu behandeln oder dem Benutzer status zu melden.
E_ABORT	Der Benutzer hat sich entschieden, die Übertragung als Reaktion auf das angezeigte Dialogfeld abzubrechen.

Bemerkungen

Windows Image Acquisition (WIA) 2.0 ruft IWiaErrorHandler::ReportStatus auf, wenn der Treiber eine IT_MSG_DEVICE_STATUS Nachricht an BandedDataCallback sendet. Diese Methode verarbeitet die Meldung und zeigt dem Benutzer Informationen über die status oder den Fehler an. Wenn es sich bei der Meldung um einen Fehler handelt, kann der Benutzer mit der -Methode nach Möglichkeit auswählen, ob versucht werden soll, den Fehler zu beheben und die Übertragung fortzusetzen oder abzubrechen.

hrStatus ist auf WIA_STATUS_TRANSFER_BEGIN festgelegt, um den Handler darüber zu informieren, dass eine Übertragung gestartet wurde. Sie ist auf WIA_STATUS_TRANSFER_END festgelegt, wenn die Übertragung abgeschlossen ist.

Wenn hrStatus SEVERITY_SUCCESS ist, sollte der Benutzer die Übertragung abbrechen können.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Header	Wia.h
IDL	Wia.idl
Bibliothek	Wiaguid.lib

Freigeben über