Plataforma::Classe COMException

Representa 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.

O COMException também tem os seguintes tipos de membros.

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 classe Platform::Object.

imóveis

A classe COMException tem as seguintes propriedades.

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

Exceções derivadas

As seguintes exceções predefinidas são derivadas de COMException. Eles diferem de COMException apenas em seu nome, o nome de seu construtor e seu valor HRESULT subjacente.

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

Requerimentos

Cliente mínimo suportado: Windows 8

Servidor mínimo suportado: Windows Server 2012

Namespace: Plataforma

Metadados: platform.winmd

COMException::COMException Construtor

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, consulte Estrutura de códigos de erro 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.

Ver também

de namespace da plataforma