Cómo: Asignar resultados HRESULT y excepciones

Actualización: noviembre 2007

Los métodos COM informan de los errores devolviendo resultados HRESULT, mientras que los métodos .NET lo hacen produciendo excepciones. El motor en tiempo de ejecución controla la transición entre ambos. Cada clase de excepción de .NET Framework se asigna a un resultado HRESULT.

Las clases de excepción definidas por el usuario pueden especificar el resultado HRESULT que sea adecuado. Estas clases de excepción pueden cambiar dinámicamente el resultado HRESULT que se devolverá cuando se genere la excepción estableciendo el campo HResult en el objeto de excepción. El cliente recibe información adicional acerca de la excepción mediante la interfaz IErrorInfo, que se implementa en el objeto .NET en el proceso no administrado.

Si se crea una clase que extiende System.Exception, se debe establecer el campo HRESULT en el momento de la creación. De lo contrario, el valor HRESULT lo asigna la clase base. A un resultado HRESULT existente se le pueden asignar nuevas clases de excepción proporcionando el valor en el constructor de la excepción.

Observe que el motor en tiempo de ejecución a veces omitirá HRESULT en los casos en los que exista IErrorInfo en el subproceso. Este comportamiento se puede producir en los casos en los que HRESULT y IErrorInfo no representen el mismo error.

Crear una nueva clase de excepción y asignarla a un HRESULT

• Utilice el código siguiente para crear una nueva clase de excepción llamada NoAccessException y asignarla al HRESULT E_ACCESSDENIED.

  Class NoAccessException : public ApplicationException
  {
      NoAccessException () {
      HResult = E_ACCESSDENIED; 
  }
  }
  CMyClass::MethodThatThrows
  {
  throw new NoAccessException();
  }
  

Puede haber algún programa (en cualquier lenguaje de programación) que use código administrado y no administrado a la vez. Por ejemplo, el contador de referencias personalizado del ejemplo de código siguiente usa el método Marshal.ThrowExceptionForHR(int HResult) para producir una excepción con un valor específico de HRESULT. El método busca el resultado HRESULT y genera el tipo de excepción adecuado. Así, el resultado HRESULT del siguiente fragmento de código genera ArgumentException.

CMyClass::MethodThatThrows
{
    Marshal.ThrowExceptionForHR(COR_E_ARGUMENT);
}

En la tabla siguiente se proporcionan todas las asignaciones de cada resultado HRESULT a su clase de excepción correspondiente en .NET Framework.

Para recuperar información de errores extendida, el cliente administrado debe examinar los campos del objeto de excepción generado. Para que el objeto de excepción proporcione información útil acerca del error, el objeto COM debe implementar la interfaz IErrorInfo. El motor de tiempo de ejecución usa la información que proporciona IErrorInfo para inicializar el objeto de excepción.

Si el objeto COM no es compatible con IErrorInfo, el motor de tiempo de ejecución inicializa un objeto de excepción con los valores predeterminados. En la tabla siguiente se enumera cada uno de los campos asociados a un objeto de excepción y se identifica el origen de la información predeterminada cuando el objeto COM es compatible con IErrorInfo.

Observe que el motor en tiempo de ejecución a veces omitirá HRESULT en los casos en los que exista IErrorInfo en el subproceso. Este comportamiento se puede producir en los casos en los que HRESULT y IErrorInfo no representen el mismo error.

Los campos de excepción tales como Message, Source y StackTrace no están disponibles para StackOverflowException.

Vea también

Otros recursos

Interoperabilidad COM avanzada

Controlar y generar excepciones