Usar macros para el control de errores
COM define una serie de macros que facilitan el trabajo con valores HRESULT .
Las macros de control de errores se describen en la tabla siguiente.
Macro | Descripción |
---|---|
MAKE_HRESULT |
Devuelve un VALOR HRESULT según el bit de gravedad, el código de instalación y el código de error que componen hrESULT. Nota: Llamar a MAKE_HRESULT para S_OK comprobación conlleva una penalización de rendimiento. No debe usar de forma rutinaria MAKE_HRESULT para obtener resultados correctos. |
MAKE_SCODE |
Devuelve un SCODE según el bit de gravedad, el código de instalación y el código de error que componen el SCODE. |
HRESULT_CODE |
Extrae la parte del código de error de HRESULT. |
HRESULT_FACILITY |
Extrae el código de instalación del HRESULT. |
HRESULT_SEVERITY |
Extrae el bit de gravedad de HRESULT. |
SCODE_CODE |
Extrae la parte del código de error de SCODE. |
SCODE_FACILITY |
Extrae el código de instalación del SCODE. |
SCODE_SEVERITY |
Extrae el campo de gravedad del SCODE. |
TUVO ÉXITO |
Comprueba el bit de gravedad del SCODE o HRESULT; devuelve TRUE si la gravedad es cero y FALSE si es una. |
FALLADO |
Comprueba el bit de gravedad del SCODE o HRESULT; devuelve TRUE si la gravedad es una y FALSE si es cero. |
IS_ERROR |
Proporciona una prueba genérica para errores en cualquier valor de estado. |
HRESULT_FROM_WIN32 |
Asigna un código de error del sistema a un valor HRESULT . |
HRESULT_FROM_NT |
Asigna un valor de estado NT a un valor HRESULT . |