Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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.