Platform::COMException (Clase)
Representa los errores COM que se producen durante la ejecución de una aplicación. COMException es la clase base para un conjunto de excepciones estándar predefinidas.
Sintaxis
public ref class COMException : Exception, IException, IPrintable, IEquatable
Miembros
La clase COMException hereda de la clase Object y las interfaces IException, IPrintable e IEquatable.
COMException también tiene los siguientes tipos de miembros.
Constructores
| Miembro | Descripción |
|---|---|
| COMException | Inicializa una nueva instancia de la clase COMException. |
Métodos
La clase COMException hereda los métodos Equals(), Finalize(), GetHashCode(), GetType(), MemberwiseClose() y ToString() de Platform::Object Class.
Propiedades
La clase COMException tiene las propiedades siguientes.
| Miembro | Descripción |
|---|---|
| Exception::HResult | HRESULT correspondiente a la excepción. |
| Exception::Message | Mensaje que describe la excepción. |
Excepciones derivadas
Las excepciones predefinidas siguientes se derivan de COMException. Difieren de COMException únicamente en su nombre, el nombre de su constructor y el valor HRESULT subyacente.
| Nombre | HRESULT subyacente | Descripción |
|---|---|---|
| COMException | hresult definido por el usuario | Se produce cuando se devuelve un HRESULT no reconocido de una llamada al método COM. |
| AccessDeniedException | E_ACCESSDENIED | Se produce cuando se deniega el acceso a un recurso o a una característica. |
| ChangedStateException | E_CHANGED_STATE | Se produce cuando los métodos de un iterador de colección o de una vista de colección se invocan después de que la colección principal haya cambiado, invalidando los resultados del método. |
| ClassNotRegisteredException | REGDB_E_CLASSNOTREG | Se produce cuando una clase COM no se ha registrado. |
| DisconnectedException | RPC_E_DISCONNECTED | Se produce cuando un objeto se desconecta de sus clientes. |
| FailureException | E_FAIL | Se produce cuando una operación no es correcta. |
| InvalidArgumentException | E_INVALIDARG | Se produce cuando uno de los argumentos proporcionados a un método no es válido. |
| InvalidCastException | E_NOINTERFACE | Se produce cuando un tipo no puede convertirse a otro tipo. |
| NotImplementedException | E_NOTIMPL | Se produce si un método de interfaz no se ha implementado en una clase. |
| NullReferenceException | E_POINTER | Se produce cuando se intenta desreferenciar una referencia de un objeto null. |
| OperationCanceledException | E_ABORT | Se produce cuando se anula una operación. |
| OutOfBoundsException | E_BOUNDS | Se produce cuando una operación intenta tener acceso a datos que están fuera del intervalo válido. |
| OutOfMemoryException | E_OUTOFMEMORY | Se produce cuando la memoria es insuficiente para completar la operación. |
Requisitos
Cliente mínimo compatible: Windows 8
Servidor mínimo compatible: Windows Server 2012
Espacio de nombres: Plataforma
Metadatos: platform.winmd
COMException::COMException (Constructor)
Inicializa una nueva instancia de la clase COMException.
Sintaxis
COMException( int hresult )
Parámetros
hresult
Valor HRESULT de error representado por la excepción.
COMException::HResult (Propiedad)
HRESULT correspondiente a la excepción.
Sintaxis
public:
property int HResult { int get();}
Valor de propiedad
Valor HRESULT que especifica el error.
Comentarios
Para más información sobre cómo interpretar el valor HRESULT, vea Estructura de los códigos de error COM.
COMException::Message (Propiedad)
Mensaje que describe la excepción.
Sintaxis
public:property String^ Message { String^ get();}
Valor de propiedad
Descripción de la excepción.