IWiaErrorHandler::ReportStatus-Methode

Behandelt Status- und Fehlermeldungen während Bilddatenübertragungen 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.

-Item [ In]

Typ: IUnknown*

Zeiger auf die IUnknown-Schnittstelle des elements, das übertragen wird. Dieses Objekt implementiert IWiaItem2 und IWiaDataTransfer minimal.

hrStatus [ In]

Typ: HRESULT

HRESULT, bei dem es sich um den Statuscode 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 ergriffen, um den Fehler zu behandeln oder dem Benutzer den Status zu melden.
E _ ABORT
Der Benutzer hat die Übertragung als Reaktion auf das angezeigte Dialogfeld abgebrochen.

Hinweise

Windows Image Acquisition (WIA) 2.0 ruft IWiaErrorHandler::ReportStatus auf, wenn der Treiber eine IT _ MSG _ DEVICE _ STATUS-Meldung an BandedDataCallback sendet. Diese Methode verarbeitet die Meldung und zeigt dem Benutzer Informationen zum Status oder Fehler an. Wenn es sich bei der Meldung um einen Fehler handelt, kann der Benutzer mit der -Methode nach Möglichkeit auswählen, ob nach dem Fehler eine Wiederherstellung versucht und die Übertragung fortgesetzt oder abgebrochen werden soll.

hrStatus ist auf WIA STATUS TRANSFER BEGIN festgelegt, um den Handler zu informieren, _ dass eine Übertragung gestartet _ _ wurde. Sie wird auf WIA _ STATUS _ TRANSFER END _ festgelegt, wenn die Übertragung abgeschlossen ist.

Wenn hrStatus den Schweregrad ERFOLG hat, sollte der Benutzer _ die Übertragung abbrechen dürfen.

Anforderungen

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