Freigeben über


Strategien zur Fehlerbehandlung

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