Fehlerbehandlung in COM (COM)
Fast alle COM-Funktionen und Schnittstellenmethoden geben einen Wert des Typs HRESULT-zurück. Die HRESULT- (der Name kann als "Ergebnishandle" gelesen werden) ist eine Möglichkeit zum Zurückgeben eines Erfolgs, einer Warnung oder eines Fehlerwerts. Ein HRESULT- ist eigentlich kein Handle (siehe Warum beginnt HRESULT mit H, wenn es kein Handle für etwas ist?); es ist nur ein Wert mit mehreren Feldern, die darin codiert sind. Gemäß der COM-Spezifikation gibt ein Ergebnis von Null erfolg an, und ein Nichtzero-Ergebnis gibt einen Fehler an.
Auf Der Quellcodeebene bestehen alle Fehlerwerte aus drei Teilen, getrennt durch Unterstriche. Der erste Teil ist das Präfix, das die dem Fehler zugeordnete Einrichtung identifiziert, der zweite Teil ist E für Fehler, und der dritte Teil ist eine Zeichenfolge, die die tatsächliche Bedingung beschreibt. Beispielsweise wird STG_E_MEDIUMFULL zurückgegeben, wenn kein Speicherplatz auf einer Festplatte vorhanden ist. Das präfix STG- gibt die Speichereinrichtung an, die E- gibt an, dass der Statuscode einen Fehler darstellt, und die MEDIUMFULL- enthält spezifische Informationen zum Fehler. Viele der Werte, die Sie möglicherweise aus einer Schnittstellenmethode oder -funktion zurückgeben möchten, sind in Winerror.h definiert.
Weitere Informationen zur Fehlerbehandlung finden Sie in den folgenden Abschnitten:
- Struktur der COM-Fehlercodes
- Codes in FACILITY_ITF
- Verwenden von Makros für die Fehlerbehandlung
- COM-Fehlerbehandlung in Java und Visual Basic
- Strategien zur Fehlerbehandlung
- Behandlung unbekannter Fehler
Verwandte Themen