Platform::COMException Class

2 out of 2 rated this helpful - Rate this topic

Represents COM errors that occur during application execution. COMException is the base class for a set of predefined, standard exceptions.

C++


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 Property	The HRESULT that corresponds to the exception.
Exception::Message Property	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

Reference

Platform namespace (C++/CX)

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)