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.