Verwenden von Makros für die Fehlerbehandlung
COM definiert eine Reihe von Makros, die die Arbeit mit HRESULT-Werten vereinfachen.
Die Fehlerbehandlungsmakros werden in der folgenden Tabelle beschrieben.
| Makro | Beschreibung |
|---|---|
| MAKE_HRESULT |
Gibt ein HRESULT zurück, wenn das Schweregradbit, der Einrichtungscode und der Fehlercode angegeben werden, aus dem das HRESULT besteht.[!Note] |
| MAKE_SCODE |
Gibt einen SCODE zurück, wenn das Schweregradbit, der Einrichtungscode und der Fehlercode angegeben werden, aus dem der SCODE besteht. |
| HRESULT_CODE |
Extrahiert den Fehlercodeteil von HRESULT. |
| HRESULT_FACILITY |
Extrahiert den Einrichtungscode von HRESULT. |
| HRESULT_SEVERITY |
Extrahiert das Schweregradbit von HRESULT. |
| SCODE_CODE |
Extrahiert den Fehlercodeteil von SCODE. |
| SCODE_FACILITY |
Extrahiert den Einrichtungscode von SCODE. |
| SCODE_SEVERITY |
Extrahiert das Schweregradfeld von SCODE. |
| GELUNGEN |
Testet das Schweregradbit von SCODE oder HRESULT. gibt TRUE zurück, wenn der Schweregrad 0 (null) ist, und FALSE, wenn er eins ist. |
| FEHLGESCHLAGEN |
Testet das Schweregradbit von SCODE oder HRESULT. gibt TRUE zurück, wenn der Schweregrad 1 ist, und FALSE, wenn er 0 (null) ist. |
| IS_ERROR |
Stellt einen generischen Test auf Fehler für einen beliebigen Statuswert zur Seite. |
| HRESULT_FROM_WIN32 |
Karten einen Systemfehlercode in einen HRESULT-Wert. |
| HRESULT_FROM_NT |
Karten einen NT-Statuswert in einen HRESULT-Wert. |