Cómo: Asignar HRESULT y excepciones

Los métodos COM notifican los errores devolviendo valores HRESULT; los métodos de .NET los notifican lanzando excepciones. El tiempo de ejecución controla la transición entre los dos. Cada clase de excepción de .NET se asigna a un HRESULT.

Las clases de excepción definidas por el usuario pueden especificar cualquier HRESULT que sea adecuado. Estas clases de excepción pueden cambiar dinámicamente el valor HRESULT que se devolverá cuando se genera la excepción estableciendo el HResult campo en el objeto de excepción. Se proporciona información adicional sobre la excepción al cliente a través de la IErrorInfo interfaz , que se implementa en el objeto .NET en el proceso no administrado.

Si crea una clase que extiende System.Exception, debe establecer el campo HRESULT durante la construcción. De lo contrario, la clase base asigna el valor HRESULT. Puede asignar nuevas clases de excepción a un HRESULT existente proporcionando el valor en el constructor de la excepción.

Tenga en cuenta que el entorno de ejecución a veces ignorará un HRESULT en los casos en que haya un IErrorInfo presente en el hilo. Este comportamiento puede producirse en casos en los que el HRESULT y el IErrorInfo no representan el mismo error.

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

1. Use el código siguiente para crear una nueva clase de excepción denominada NoAccessException y asignarla a HRESULT E_ACCESSDENIED.

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

Es posible que encuentre un programa (en cualquier lenguaje de programación) que use código administrado y no administrado al mismo tiempo. Por ejemplo, el marshalizador personalizado del siguiente ejemplo de código usa el método Marshal.ThrowExceptionForHR(int HResult) para generar una excepción con un valor HRESULT específico. El método busca hrESULT y genera el tipo de excepción adecuado. Por ejemplo, HRESULT en el fragmento de código siguiente genera ArgumentException.

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

En la tabla siguiente se muestran las correspondencias habituales entre HRESULT y su clase de excepción equivalente en .NET. Los valores HRESULT sin asignaciones explícitas se asignan a COMException. La correspondencia completa y actualizada se puede encontrar en el repositorio dotnet/runtime.

Para recuperar información de error extendida, el cliente administrado debe examinar los campos del objeto de excepción que se generó. Para que el objeto de excepción proporcione información útil sobre un error, el objeto COM debe implementar la IErrorInfo interfaz . El tiempo de ejecución usa la información proporcionada por IErrorInfo para inicializar el objeto de excepción.

Si el objeto COM no admite IErrorInfo, el tiempo de ejecución inicializa un objeto de excepción con valores predeterminados. En la tabla siguiente se enumeran todos los campos asociados a un objeto de excepción e identifica el origen de la información predeterminada cuando el objeto COM admite IErrorInfo.

Tenga en cuenta que el entorno de ejecución a veces ignorará un HRESULT en los casos en que haya un IErrorInfo presente en el hilo. Este comportamiento puede producirse en los casos en que HRESULT y IErrorInfo no representan el mismo error.

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

Consulte también

• Interoperabilidad COM avanzada
• Excepciones