Como: MAP HRESULTs and Exceptions

Métodos COM relatar erros, retornando HRESULTs; métodos .NET relatá-los por gerar exceções.O tempo de execução manipula a transição entre os dois.Cada classe de exceção do .NET estrutura mapeia para um HRESULT.

Classes de exceção definido pelo usuário podem especificar que HRESULT é apropriado.Essas classes de exceção podem alterar dinamicamente o HRESULT a ser retornado quando a exceção é gerada, definindo o HResult campo no objeto de exceção.São fornecidas informações adicionais sobre a exceção para o cliente através de IErrorInfo interface, que é implementada no objeto do .NET no processo não gerenciado.

Se você criar uma classe que estende sistema.exceção, você deve conjunto o campo HRESULT durante a construção.Caso contrário, a classe base atribui o valor HRESULT.Você pode MAP novas classes de exceção para um HRESULT existente, fornecendo o valor no construtor da exceção.

Observe que o tempo de execução irá ignorar algumas vezes um HRESULT em casos onde há um IErrorInfo presente no segmento. Esse comportamento pode ocorrer em casos onde o HRESULT e o IErrorInfo não representam o mesmo erro.

Para criar uma nova classe de exceção e MAP-lo para um HRESULT

• Use o código a seguir para criar uma nova classe de exceção chamada NoAccessException e mapeá-lo para o HRESULT E_ACCESSDENIED.

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

Você pode encontrar um programa (em qualquer linguagem de programação) que usa código gerenciado e ao mesmo time.Por exemplo, o empacotador personalizado no exemplo de código a seguir usa o realizar marshaling.ThrowExceptionForHR (int HResult) método lançar uma exceção com um valor HRESULT específico.O método procura o HRESULT e gera o tipo de exceção apropriado.Por exemplo, o HRESULT no fragmento de código a seguir gera ArgumentException.

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

A tabela a seguir fornece o mapeamento completo de cada HRESULT à sua classe de exceção comparável no .NET estrutura.

Para recuperar informações de erro estendidas, o cliente gerenciado deve examinar os campos do objeto de exceção foi gerada.Para o objeto de exceção fornecer informações úteis sobre um erro, o objeto COM deve implementar o IErrorInfo interface.O tempo de execução usa as informações fornecidas por IErrorInfo para inicializar o objeto de exceção.

Se o objeto COM não oferece suporte a IErrorInfo, o tempo de execução inicializa um objeto de exceção com valores padrão.A tabela a seguir lista cada campo associado a um objeto de exceção e identifica a fonte de informações padrão quando o objeto COM dá suporte a IErrorInfo.

Observe que o tempo de execução irá ignorar algumas vezes um HRESULT em casos onde há um IErrorInfo presente no segmento. Esse comportamento pode ocorrer em casos onde o HRESULT e o IErrorInfo não representam o mesmo erro.

Campos de exceção, sistema autônomo Mensagem, fonte, and StackTrace não estão disponível para o StackOverflowException.

Consulte também

Outros recursos

Interoperabilidade COM avançada

Tratamento e lançamento de exceções