Uso di macro per la gestione degli errori
COM definisce una serie di macro che semplificano il funzionamento con valori HRESULT.
Le macro di gestione degli errori sono descritte nella tabella seguente.
| Macro | Descrizione |
|---|---|
|
MAKE_HRESULT |
Restituisce un HRESULT in base al bit di severità, al codice dell'impianto e al codice di errore che costituiscono il HRESULT. Nota: Chiamare MAKE_HRESULT per la verifica di S_OK comporta un impatto negativo sulle prestazioni. Non è consigliabile usare regolarmente MAKE_HRESULT per ottenere risultati riusciti. |
|
MAKE_SCODE |
Restituisce un SCODE in base al bit di gravità, al codice della struttura e al codice di errore che compongono il SCODE. |
|
HRESULT_CODE |
Estrae la parte del codice di errore del HRESULT. |
|
HRESULT_FACILITY |
Estrae il codice della struttura del HRESULT. |
|
HRESULT_SEVERITY |
Estrae il bit di gravità dell'HRESULT . |
|
SCODE_CODE |
Estrae la parte del codice di errore del SCODE. |
|
SCODE_FACILITY |
Estrae il codice identificativo della struttura del SCODE. |
|
SCODE_SEVERITY |
Estrae il campo di gravità del SCODE. |
|
RIUSCITO |
Verifica il bit di gravità del SCODE o HRESULT; restituisce TRUE se la gravità è zero e FALSE se è uno. |
|
NON RIUSCITO |
Verifica il bit di gravità del SCODE o HRESULT; restituisce TRUE se la gravità è uno e FALSE se è zero. |
|
IS_ERROR |
Fornisce un test generico per gli errori in qualsiasi valore di stato. |
|
HRESULT_FROM_WIN32 |
Converte un codice di errore di sistema in un valore HRESULT . |
|
HRESULT_FROM_NT |
Mappa un valore di stato NT in un valore HRESULT . |