Platform::COMException Class
Represents COM errors that occur during application execution. COMException is the base class for a set of predefined, standard exceptions.
Syntax
public ref class COMException : Exception, IException, IPrintable, IEquatable
Members
The COMException class inherits from the Object class and the IException, IPrintable, and IEquatable interfaces.
COMException also has the following types of members.
Constructors
| Member | Description |
|---|---|
| COMException | Initializes a new instance of the COMException class. |
Methods
The COMException class inherits the Equals(), Finalize(), GetHashCode(), GetType(), MemberwiseClose(), and ToString() methods from the Platform::Object Class.
Properties
The COMException class has the following properties.
| Member | Description |
|---|---|
| Exception::HResult | The HRESULT that corresponds to the exception. |
| Exception::Message | Message that describes the exception. |
Derived Exceptions
The following predefined exceptions are derived from COMException. They differ from COMException only in their name, the name of their constructor, and their underlying HRESULT value.
| Name | Underlying HRESULT | Description |
|---|---|---|
| COMException | user-defined hresult | Thrown when an unrecognized HRESULT is returned from a COM method call. |
| AccessDeniedException | E_ACCESSDENIED | Thrown when access is denied to a resource or feature. |
| ChangedStateException | E_CHANGED_STATE | 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. |
| ClassNotRegisteredException | REGDB_E_CLASSNOTREG | Thrown when a COM class has not been registered. |
| DisconnectedException | RPC_E_DISCONNECTED | Thrown when an object is disconnected from its clients. |
| FailureException | E_FAIL | Thrown when an operation fails. |
| InvalidArgumentException | E_INVALIDARG | Thrown when one of the arguments provided to a method is not valid. |
| InvalidCastException | E_NOINTERFACE | Thrown when a type can't be cast to another type. |
| NotImplementedException | E_NOTIMPL | Thrown if an interface method hasn't been implemented on a class. |
| NullReferenceException | E_POINTER | Thrown when there is an attempt to dereference a null object reference. |
| OperationCanceledException | E_ABORT | Thrown when an operation is aborted. |
| OutOfBoundsException | E_BOUNDS | Thrown when an operation attempts to access data outside the valid range. |
| OutOfMemoryException | E_OUTOFMEMORY | Thrown when there's insufficient memory to complete the operation. |
Requirements
Minimum supported client: Windows 8
Minimum supported server: Windows Server 2012
Namespace: Platform
Metadata: platform.winmd
COMException::COMException Constructor
Intializes a new instance of the COMException class.
Syntax
COMException( int hresult )
Parameters
hresult
The error HRESULT that is represented by the exception.
COMException::HResult Property
The HRESULT that corresponds to the exception.
Syntax
public:
property int HResult { int get();}
Property Value
An HRESULT value that specifies the error.
Remarks
For more information about how to interpret the HRESULT value, see Structure of COM Error Codes.
COMException::Message Property
Message that describes the exception.
Syntax
public:property String^ Message { String^ get();}
Property Value
A description of the exception.