Procedimiento para asignar resultados HRESULT y excepciones

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

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

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

Tenga en cuenta que a veces el tiempo de ejecución omitirá un valor HRESULT en casos donde hay una IErrorInfo presente en el subproceso. Este comportamiento puede aparecer en casos donde HRESULT y IErrorInfo no representan el mismo error.

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

1. Use el código siguiente para crear una nueva clase de excepción denominada NoAccessException y asignarla al valor 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 tanto código administrado como no administrado al mismo tiempo. Por ejemplo, el administrador de serialización personalizado del ejemplo de código siguiente usa el método Marshal.ThrowExceptionForHR(int HResult) para iniciar una excepción con un valor HRESULT específico. El método busca el valor HRESULT y genera el tipo de excepción adecuado. Por ejemplo, el valor de HRESULT en el fragmento de código siguiente genera ArgumentException.

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

En la tabla siguiente se proporcionan las asignaciones comunes de HRESULT a su clase de excepción comparable en .NET. Los valores de HRESULT sin asignaciones explícitas se asignan a COMException. La asignación actualizada completa se puede encontrar en el repositorio de dotnet/runtime.

Para recuperar información de error ampliada, 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 interfaz IErrorInfo. El runtime usa la información proporcionada por IErrorInfo para inicializar el objeto de excepción.

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

Tenga en cuenta que a veces el tiempo de ejecución omitirá un valor HRESULT en casos donde hay una IErrorInfo presente en el subproceso. Este comportamiento puede aparecer en casos donde HRESULT y IErrorInfo no representan el mismo error.

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

Vea también

• Interoperabilidad COM avanzada
• Excepciones