IWiaAppErrorHandler::ReportStatus-Methode

Artikel
06/13/2023

Behandelt Geräte-status und Fehlermeldungen während der Bilddatenübertragung und zeigt die Meldungen dem Benutzer an.

Syntax

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

Parameter

lFlags [in]

Typ: LONG

Nicht verwendet. Auf 0 festlegen.

pWiaItem2 [in]

Typ: IWiaItem2*

Zeiger auf das element, das übertragen wird.

hrStatus [in]

Typ: HRESULT

Gerätecode status.

lPercentComplete [in]

Typ: LONG

Prozentsatz des abgeschlossenen aktuellen Vorgangs.

Rückgabewert

Typ: HRESULT

Gibt hrStatus zurück, wenn die Wiederherstellung nach dem Fehler nicht möglich ist. Andernfalls wird einer der folgenden Werte zurückgegeben.

Rückgabecode	BESCHREIBUNG
S_OK	Wenn hrStatus ein Fehler ist, wurde die entsprechende Aktion zum Beheben des Fehlers ausgeführt, und die Übertragung kann fortgesetzt werden. Wenn hrStatus informational ist, wurde der Benutzer über ein modusloses Dialogfeld informiert und entschied sich, die Übertragung nicht abzubrechen.
S_FALSE	Der Benutzer hat die Übertragung aus dem dialogfeld "Fehlerhandler ohne Modus" abgebrochen. Dieser Wert kann jederzeit zurückgegeben werden, unabhängig davon, was hrStatus ist.
WIA_STATUS_NOT_HANDLED	Es wurden keine Maßnahmen ergriffen; Das heißt, dem Benutzer wurde kein Dialogfeld angezeigt. Der nächste Fehlerhandler wird aufgerufen. Die Reihenfolge der Fehlerhandler lautet: Anwendung, Treiber und Systemstandard.

Bemerkungen

Der Parameter lPercentComplete aktiviert ein Fehlerhandlerfenster, um den Fortschritt anzuzeigen. Beispielsweise kann ein Fahrer eine Schätzung der Dauer des "Aufwärmens" angeben. Der lPercentComplete-Parameter , der an IWiaAppErrorHandler::ReportStatus übergeben wird, ist derselbe Wert wie der lPercentComplete , den der Treiber in der WiaTransferParams-Struktur festlegt.

Ein Fehlerhandler kann die Makros SUCCEEDED und FAILED verwenden, um herauszufinden, ob hrStatus über SEVERITY_ERROR oder SEVERITY_SUCCESS verfügt.

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

Wenn hrStatus SEVERITY_ERROR ist, sollte der Fehlerhandler ein modales Dialogfeld anzeigen, das dem übergeordneten Anwendungsfenster gehört.

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