Strategien zur Fehlerbehandlung

  • Artikel

Da Schnittstellenmethoden virtuell sind, ist es für einen Aufrufer nicht möglich, den vollständigen Satz von Werten zu kennen, die von einem einzelnen Aufruf zurückgegeben werden können. Eine Implementierung einer Methode kann fünf Werte zurückgeben. ein anderer kann acht zurückgeben.

In der Dokumentation sind allgemeine Werte aufgeführt, die für jede Methode zurückgegeben werden können. Dies sind die Werte, die Sie im Code überprüfen und behandeln müssen, da sie eine besondere Bedeutung haben. Andere Werte werden möglicherweise zurückgegeben, aber da sie nicht sinnvoll sind, müssen Sie keinen speziellen Code schreiben, um sie zu behandeln. Eine einfache Überprüfung auf null oder ungleich Null ist ausreichend.

HRESULT-Werte

Der Rückgabewert von COM-Funktionen und -Methoden ist ein HRESULT. Die Werte einiger HRESULTs wurden in COM geändert, um jegliche Duplizierung und Überlappung mit den Systemfehlercodes zu vermeiden. Diejenigen, die Systemfehlercodes duplizieren, wurden in FACILITY_WIN32 geändert, und diejenigen, die sich überschneiden, verbleiben in FACILITY_NULL. Allgemeine HRESULT-Werte und deren Werte sind in der folgenden Tabelle aufgeführt.

HRESULT Wert BESCHREIBUNG
E_ABORT
 0x80004004
 Der Vorgang wurde aufgrund eines nicht angegebenen Fehlers abgebrochen.
E_ACCESSDENIED
 0x80070005
 Ein allgemeiner Fehler, der zugriff verweigert wurde.
E_FAIL
 0x80004005
 Ein nicht angegebener Fehler ist aufgetreten.
E_HANDLE
 0x80070006
 Es wurde ein ungültiges Handle verwendet.
E_INVALIDARG
 0x80070057
 Mindestens ein Argument ist ungültig.
E_NOINTERFACE
 0x80004002
 Die QueryInterface-Methode hat die angeforderte Schnittstelle nicht erkannt. Die Schnittstelle wird nicht unterstützt.
E_NOTIMPL
 0x80004001
 Die Methode ist nicht implementiert.
E_OUTOFMEMORY
 0x8007000E
 Die -Methode konnte den erforderlichen Arbeitsspeicher nicht zuordnen.
E_PENDING
 0x8000000A
 Die zum Abschließen des Vorgangs erforderlichen Daten sind noch nicht verfügbar.
E_POINTER
 0x80004003
 Ein ungültiger Zeiger wurde verwendet.
E_UNEXPECTED
 0x8000FFFF
 Es ist ein schwerwiegender Fehler aufgetreten.
S_FALSE
 0x00000001
 Die Methode war erfolgreich und hat den booleschen Wert FALSE zurückgegeben.
S_OK
 0x00000000
 Die Methode wurde erfolgreich ausgeführt. Wenn ein boolescher Rückgabewert erwartet wird, ist der zurückgegebene Wert TRUE.

Netzwerkfehler

Wenn die ersten vier Ziffern des Fehlercodes 8007 sind, weist dies auf einen System- oder Netzwerkfehler hin. Sie können den Net-Befehl verwenden, um diese Fehlertypen zu decodieren. Um den Fehler zu decodieren, konvertieren Sie zuerst die letzten vier Ziffern des hexadezimalen Fehlercodes in dezimal. Geben Sie dann an der Eingabeaufforderung Folgendes ein, wobei dezimaler Code durch den Rückgabewert ersetzt wird, den Sie decodieren möchten:

net helpmsg <decimal_code>

Der Net-Befehl gibt eine Beschreibung des Fehlers zurück. Wenn COM beispielsweise den Fehler 8007054B zurückgibt, konvertieren Sie 054B in dezimal (1355). Geben Sie anschließend Folgendes ein:

net helpmsg 1355

Der Befehl net gibt die Fehlerbeschreibung zurück: "Die angegebene Domäne war nicht vorhanden".

Fehlerbehandlung in COM