Estrategias de control de errores

  • Artículo

Dado que los métodos de interfaz son virtuales, no es posible que un autor de la llamada conozca el conjunto completo de valores que se pueden devolver desde cualquier llamada. Una implementación de un método puede devolver cinco valores; otro puede devolver ocho.

En la documentación se enumeran los valores comunes que se pueden devolver para cada método; estos son los valores que debe comprobar y controlar en el código porque tienen significados especiales. Es posible que se devuelvan otros valores, pero como no son significativos, no es necesario escribir código especial para controlarlos. Una comprobación simple de cero o distinto de cero es adecuada.

Valores HRESULT

El valor devuelto de las funciones y los métodos COM es hrESULT. Los valores de algunos HRESULT se han cambiado en COM para eliminar toda duplicación y superposición con los códigos de error del sistema. Los que duplican los códigos de error del sistema se han cambiado a FACILITY_WIN32 y los que se superponen permanecen en FACILITY_NULL. Los valores HRESULT comunes y sus valores se enumeran en la tabla siguiente.

HRESULT Valor Descripción
E_ABORT
 0x80004004
 La operación se anuló debido a un error no especificado.
E_ACCESSDENIED
 0x80070005
 Un error general de acceso denegado.
E_FAIL
 0x80004005
 Se ha producido un error no especificado.
E_HANDLE
 0x80070006
 Se usó un identificador no válido.
E_INVALIDARG
 0x80070057
 Uno o más argumentos no son válidos.
E_NOINTERFACE
 0x80004002
 El método QueryInterface no reconoció la interfaz solicitada. No se admite la interfaz .
E_NOTIMPL
 0x80004001
 El método no está implementado.
E_OUTOFMEMORY
 0x8007000E
 El método no pudo asignar la memoria necesaria.
E_PENDING
 0x8000000A
 Los datos necesarios para completar la operación aún no están disponibles.
E_POINTER
 0x80004003
 Se usó un puntero no válido.
E_UNEXPECTED
 0x8000FFFF
 Se ha producido un error catastrófico.
S_FALSE
 0x00000001
 El método se realizó correctamente y devolvió el valor booleano FALSE.
S_OK
 0x00000000
 El método se ha llevado a cabo de forma correcta. Si se espera un valor devuelto booleano, el valor devuelto es TRUE.

Errores de red

Si los cuatro primeros dígitos del código de error son 8007, esto indica un error de red o del sistema. Puede usar el comando net para descodificar estos tipos de errores. Para descodificar el error, primero convierta los cuatro últimos dígitos del código de error hexadecimal en decimal. A continuación, en el símbolo del sistema, escriba lo siguiente, donde el código decimal se reemplaza por el valor devuelto que desea descodificar:

net helpmsg <decimal_code>

El comando net devuelve una descripción del error. Por ejemplo, si COM devuelve el error 8007054B, convierta 054B en decimal (1355). A continuación, escriba lo siguiente:

net helpmsg 1355

El comando net devuelve la descripción del error: "El dominio especificado no existía".

Control de errores en COM