Makrók használata hibakezeléshez
A COM számos olyan makrót határoz meg, amelyek megkönnyítik HRESULT értékek használatát.
A hibakezelő makrókat az alábbi táblázatban ismertetjük.
| Makró | Leírás |
|---|---|
|
MAKE_HRESULT |
Visszaad egy HRESULT kódot, amely a HRESULTsúlyossági bitjéből, létesítménykódjából és hibakódjából áll. Megjegyzés: az S_OK ellenőrzéséhez szükséges MAKE_HRESULT hívása teljesítménybeli hátrányt jelent. A sikeres eredményekhez nem ajánlott rutinszerűen használni a MAKE_HRESULT. |
|
MAKE_SCODE |
Visszaad egy SCODE, amelyet a súlyossági bit, létesítménykód és hibakód alkot, amelyek a SCODErészét képezik. |
|
HRESULT_CODE |
Kinyeri a HRESULThibakód részét. |
|
HRESULT_FACILITY |
Kinyeri a HRESULTlétesítménykódját. |
|
HRESULT_SEVERITY |
Kinyeri a HRESULTsúlyossági bitjét. |
|
SCODE_CODE |
Kinyeri a SCODEhibakód részét. |
|
SCODE_FACILITY |
Kinyeri a SCODElétesítménykódját. |
|
SCODE_SEVERITY |
Kinyeri a SCODEsúlyossági mezőjét. |
|
SIKERES |
A SCODE vagy HRESULTsúlyossági bitjét teszteli; visszatér IGAZ értékkel, ha a súlyosság nulla, és HAMIS értékkel, ha egy. |
|
SIKERTELEN |
Teszteli a SCODE vagy a HRESULTsúlyossági bitjét; IGAZ értéket ad vissza, ha a súlyosság egy, és HAMIS, ha az nulla. |
|
IS_ERROR |
Általános tesztet biztosít az állapotértékekkel kapcsolatos hibákhoz. |
|
HRESULT_FROM_WIN32 |
Egy rendszerhiba-kódot képez le egy HRESULT értékre. |
|
HRESULT_FROM_NT |
Egy NT-állapotérték leképezése egy HRESULT értékre. |