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 |
|---|---|
|
Die entsprechende Aktion wurde ergriffen, um den Fehler zu beheben, und die Übertragung kann fortgesetzt werden. |
|
Es wurde keine Aktion ergriffen, um den Fehler zu behandeln oder dem Benutzer den Status zu melden. |
|
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 |
|
| Idl |
|
| Bibliothek |
|