Compartilhar via


Classe Platform::COMException

Representa um ou mais erros COM que ocorrem durante a execução do aplicativo. COMException é a classe base para um conjunto de exceções padrão predefinidas.

Sintaxe

public ref class COMException : Exception,    IException,    IPrintable,    IEquatable

Membros

A classe COMException herda da classe Object e das interfaces IException, IPrintable e IEquatable.

COMException também tem os tipos de membros a seguir.

Construtores

Membro Descrição
COMException Inicializa uma nova instância da classe COMException.

Métodos

A classe COMException herda os métodos Equals(), Finalize(), GetHashCode(), GetType(), MemberwiseClose() e ToString() da Platform::Object Class.

Propriedades

A classe COMException agora tem as propriedades a seguir.

Membro Descrição
Exception::HResult O HRESULT que corresponde à exceção.
Exception::Message Mensagem que descreve a exceção.

Exceções derivadas

As exceções predefinidas a seguir são derivadas de COMException. Elas diferem de COMException apenas pelo nome, o nome de seu construtor e seu valor HRESULT subjacente.

Nome HRESULT subjacente Descrição
COMException hresult definido pelo usuário Gerada quando um HRESULT não reconhecido é retornado de um chamada de método COM.
AccessDeniedException E_ACCESSDENIED Gerada quando o acesso a um recurso é negado.
ChangedStateException E_CHANGED_STATE Gerada quando os métodos de um iterador de coleção ou uma exibição de coleção são chamados após a alteração da coleção pai, invalidando os resultados do método.
ClassNotRegisteredException REGDB_E_CLASSNOTREG Gerada quando uma classe COM não foi registrada.
DisconnectedException RPC_E_DISCONNECTED Gerada quando um objeto é desconectado de seus clientes.
FailureException E_FAIL Gerada quando uma operação falha.
InvalidArgumentException E_INVALIDARG Lançada quando um dos argumentos fornecidos a um método não é válido.
InvalidCastException E_NOINTERFACE Gerada quando um tipo não pode ser convertido em outro tipo.
NotImplementedException E_NOTIMPL Gerada se um método de interface não foi implementado em uma classe.
NullReferenceException E_POINTER Gerada quando ocorre uma tentativa de cancelar a referência de um objeto de referência nula.
OperationCanceledException E_ABORT Gerada quando uma operação é anulada.
OutOfBoundsException E_BOUNDS Gerada quando uma operação tenta acessar dados fora do intervalo válido.
OutOfMemoryException E_OUTOFMEMORY Gerada quando a memória para concluir a operação é insuficiente.

Requisitos

Cliente com suporte mínimo: Windows 8

Servidor com suporte mínimo: Windows Server 2012

Namespace: Platform

Metadados: platform.winmd

Construtor COMException::COMException

Inicializa uma nova instância da classe COMException.

Sintaxe

COMException( int hresult )

Parâmetros

hresult
O erro HRESULT que é representado pela exceção.

Propriedade COMException::HResult

O HRESULT que corresponde à exceção.

Sintaxe

public:
    property int HResult { int get();}

Valor da propriedade

Um valor HRESULT que especifica o erro.

Comentários

Para obter mais informações sobre como interpretar o valor HRESULT, confira Estrutura dos Códigos de Erro do COM.

Propriedade COMException::Message

Mensagem que descreve a exceção.

Sintaxe

public:property String^ Message {    String^ get();}

Valor da propriedade

Uma descrição da exceção.

Confira também

Namespace de plataforma