Utilisation de macros pour la gestion des erreurs
COM définit un certain nombre de macros qui facilitent l’utilisation des valeurs HRESULT .
Les macros de gestion des erreurs sont décrites dans le tableau suivant.
| Macro | Description |
|---|---|
|
MAKE_HRESULT |
Retourne un HRESULT en fonction du bit de gravité, du code d’installation et du code d’erreur qui composent le HRESULT. Note:L’appel de MAKE_HRESULT pour S_OK vérification entraîne une pénalité de performances. Vous ne devez pas utiliser systématiquement MAKE_HRESULT pour obtenir des résultats. |
|
MAKE_SCODE |
Retourne un SCODE en fonction du bit de gravité, du code d’installation et du code d’erreur qui composent le SCODE. |
|
HRESULT_CODE |
Extrait la partie de code d’erreur du HRESULT. |
|
HRESULT_FACILITY |
Extrait le code d’installation du HRESULT. |
|
HRESULT_SEVERITY |
Extrait le bit de gravité du HRESULT. |
|
SCODE_CODE |
Extrait la partie du code d’erreur du SCODE. |
|
SCODE_FACILITY |
Extrait le code d’installation du SCODE. |
|
SCODE_SEVERITY |
Extrait le champ de gravité du SCODE. |
|
RÉUSSI |
Teste le bit de gravité du SCODE ou HRESULT ; retourne TRUE si la gravité est zéro et FALSE s’il s’agit d’un. |
|
ÉCHOUÉ |
Teste le bit de gravité du SCODE ou HRESULT ; retourne TRUE si la gravité est égale à un et FALSE si elle est égale à zéro. |
|
IS_ERROR |
Fournit un test générique pour les erreurs sur n’importe quelle valeur status. |
|
HRESULT_FROM_WIN32 |
Mappe un code d’erreur système à une valeur HRESULT . |
|
HRESULT_FROM_NT |
Mappe une valeur de status NT à une valeur HRESULT. |