Classe Platform::COMExceptionPlatform::COMException Class

Representa um ou mais erros COM que ocorrem durante a execução do aplicativo.Represents COM errors that occur during application execution. COMException é a classe base para um conjunto de exceções padrão predefinidas.COMException is the base class for a set of predefined, standard exceptions.

SintaxeSyntax

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

MembrosMembers

A classe COMException herda da classe Object e das interfaces IException, IPrintable e IEquatable.The COMException class inherits from the Object class and the IException, IPrintable, and IEquatable interfaces.

COMException também tem os tipos de membros a seguir.COMException also has the following types of members.

ConstrutoresConstructors

MembroMember DescriçãoDescription
COMExceptionCOMException Inicializa uma nova instância da classe COMException.Initializes a new instance of the COMException class.

MétodosMethods

A classe COMException herda os métodos Equals(), Finalize(), GetHashCode(), GetType(), MemberwiseClose() e ToString() da Platform::Object Class.The COMException class inherits the Equals(), Finalize(), GetHashCode(), GetType(), MemberwiseClose(), and ToString() methods from the Platform::Object Class.

PropriedadesProperties

A classe COMException agora tem as propriedades a seguir.The COMException class has the following properties.

MembroMember DescriçãoDescription
Exception::HResultException::HResult O HRESULT que corresponde à exceção.The HRESULT that corresponds to the exception.
Exception::MessageException::Message Mensagem que descreve a exceção.Message that describes the exception.

Exceções derivadasDerived Exceptions

As exceções predefinidas a seguir são derivadas de COMException.The following predefined exceptions are derived from COMException. Elas diferem de COMException apenas pelo nome, o nome de seu construtor e seu valor HRESULT subjacente.They differ from COMException only in their name, the name of their constructor, and their underlying HRESULT value.

NomeName HRESULT subjacenteUnderlying HRESULT DescriçãoDescription
COMExceptionCOMException hresult definido pelo usuáriouser-defined hresult Gerada quando um HRESULT não reconhecido é retornado de um chamada de método COM.Thrown when an unrecognized HRESULT is returned from a COM method call.
AccessDeniedExceptionAccessDeniedException E_ACCESSDENIEDE_ACCESSDENIED Gerada quando o acesso a um recurso é negado.Thrown when access is denied to a resource or feature.
ChangedStateExceptionChangedStateException E_CHANGED_STATEE_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.Thrown when methods of a collection iterator or a collection view are called after the parent collection has changed, invalidating the results of the method.
ClassNotRegisteredExceptionClassNotRegisteredException REGDB_E_CLASSNOTREGREGDB_E_CLASSNOTREG Gerada quando uma classe COM não foi registrada.Thrown when a COM class has not been registered.
DisconnectedExceptionDisconnectedException RPC_E_DISCONNECTEDRPC_E_DISCONNECTED Gerada quando um objeto é desconectado de seus clientes.Thrown when an object is disconnected from its clients.
FailureExceptionFailureException E_FAILE_FAIL Gerada quando uma operação falha.Thrown when an operation fails.
InvalidArgumentExceptionInvalidArgumentException E_INVALIDARGE_INVALIDARG Lançada quando um dos argumentos fornecidos a um método não é válido.Thrown when one of the arguments provided to a method is not valid.
InvalidCastExceptionInvalidCastException E_NOINTERFACEE_NOINTERFACE Gerada quando um tipo não pode ser convertido em outro tipo.Thrown when a type can't be cast to another type.
NotImplementedExceptionNotImplementedException E_NOTIMPLE_NOTIMPL Gerada se um método de interface não foi implementado em uma classe.Thrown if an interface method hasn't been implemented on a class.
NullReferenceExceptionNullReferenceException E_POINTERE_POINTER Gerada quando ocorre uma tentativa de cancelar a referência de um objeto de referência nula.Thrown when there is an attempt to dereference a null object reference.
OperationCanceledExceptionOperationCanceledException E_ABORTE_ABORT Gerada quando uma operação é anulada.Thrown when an operation is aborted.
OutOfBoundsExceptionOutOfBoundsException E_BOUNDSE_BOUNDS Gerada quando uma operação tenta acessar dados fora do intervalo válido.Thrown when an operation attempts to access data outside the valid range.
OutOfMemoryExceptionOutOfMemoryException E_OUTOFMEMORYE_OUTOFMEMORY Gerada quando a memória para concluir a operação é insuficiente.Thrown when there's insufficient memory to complete the operation.

RequisitosRequirements

Mínimo de cliente com suporte: Windows 8Minimum supported client: Windows 8

Mínimo de servidor com suporte: Windows Server 2012Minimum supported server: Windows Server 2012

Namespace: PlatformNamespace: Platform

Metadados: platform.winmdMetadata: platform.winmd

Construtor COMException:: COMExceptionCOMException::COMException Constructor

Inicializa uma nova instância da classe COMException.Intializes a new instance of the COMException class.

SintaxeSyntax

COMException( int hresult )

ParâmetrosParameters

HRESULThresult
O erro HRESULT que é representado pela exceção.The error HRESULT that is represented by the exception.

Propriedade COMException:: HRESULTCOMException::HResult Property

O HRESULT que corresponde à exceção.The HRESULT that corresponds to the exception.

SintaxeSyntax

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

Valor de propriedadeProperty Value

Um valor HRESULT que especifica o erro.An HRESULT value that specifies the error.

ComentáriosRemarks

Para obter mais informações sobre como interpretar o valor HRESULT, consulte estrutura de códigos de erro COM.For more information about how to interpret the HRESULT value, see Structure of COM Error Codes.

Propriedade COMException:: MessageCOMException::Message Property

Mensagem que descreve a exceção.Message that describes the exception.

SintaxeSyntax

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

Valor de propriedadeProperty Value

Uma descrição da exceção.A description of the exception.

Consulte tambémSee Also

Namespace PlatformPlatform namespace