Platform::COMException-Klasse

Stellt COM-Fehler dar, die beim Ausführen einer Anwendung auftreten. COMException ist die Basisklasse für einen Satz vordefinierter Standardausnahmen.

Syntax

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

Member

Die COMException-Klasse erbt von der Object-Klasse und den Schnittstellen IException, IPrintable und IEquatable.

COMException verfügt auch über die folgenden Membertypen.

Konstruktoren

Member Beschreibung
COMException Initialisiert eine neue Instanz der COMException-Klasse.

Methoden

Die COMException-Klasse erbt die Methoden Equals(), Finalize(), GetHashCode(), GetType(), MemberwiseClose() und ToString() von der Platform::Object Class.

Eigenschaften

Die COMException-Klasse verfügt auch über die folgenden Eigenschaften.

Member Beschreibung
Ausnahme::HResult Das HRESULT, das der Ausnahme entspricht.
Exception::Message Meldung, in der die Ausnahme beschrieben wird.

Abgeleitete Ausnahmen

Die folgenden vordefinierten Ausnahmen werden von COMException abgeleitet. Sie unterscheiden sich von COMException nur im Namen, im Namen des Konstruktors und dem zugrunde liegenden HRESULT-Wert.

Name Zugrunde liegendes HRESULT Beschreibung
COMException Benutzerdefiniertes HRESULT Wird ausgelöst, wenn ein COM-Methodenaufruf ein unbekanntes HRESULT zurückgibt.
AccessDeniedException E_ACCESSDENIED Wird ausgelöst, wenn der Zugriff auf eine Ressource oder eine Funktion verweigert wird.
ChangedStateException E_CHANGED_STATE Wird ausgelöst, wenn Methoden eines Auflistungsiterators oder einer Auflistungsansicht aufgerufen werden, nachdem die übergeordnete Auflistung geändert wurde. Hierdurch werden die Ergebnisse der Methode ungültig.
ClassNotRegisteredException REGDB_E_CLASSNOTREG Wird ausgelöst, wenn eine COM-Klasse nicht registriert wurde.
DisconnectedException RPC_E_DISCONNECTED Wird ausgelöst, wenn ein Objekt von den Clients getrennt wurde.
FailureException E_FAIL Wird ausgelöst, wenn ein Vorgang fehlschlägt.
InvalidArgumentException E_INVALIDARG Wird ausgelöst, wenn eines der Argumente für eine Methode ungültig ist.
InvalidCastException E_NOINTERFACE Wird ausgelöst, wenn ein Typ nicht in einen anderen Typ umgewandelt werden kann.
NotImplementedException E_NOTIMPL Wird ausgelöst, wenn eine Schnittstellenmethode nicht bei der Klasse implementiert wurde.
NullReferenceException E_POINTER Wird ausgelöst, wenn der Versuch gemacht wird, einen Verweis auf ein NULL-Objekt zu dereferenzieren.
OperationCanceledException E_ABORT Wird nach dem Abbrechen eines Vorgangs ausgelöst.
OutOfBoundsException E_BOUNDS Wird ausgelöst, wenn ein Vorgang versucht, auf Daten außerhalb des gültigen Bereichs zuzugreifen.
OutOfMemoryException E_OUTOFMEMORY Wird ausgelöst, wenn nicht genügend Arbeitsspeicher vorhanden ist, um den Vorgang abzuschließen.

Anforderungen

Mindestens unterstützter Client: Windows 8

Mindestens unterstützter Server: Windows Server 2012

Namespace: Platform

Metadaten: platform.winmd

COMException::COMException-Konstruktor

Initialisiert eine neue Instanz der COMException-Klasse.

Syntax

COMException( int hresult )

Parameter

hresult
Der Fehler HRESULT, der durch die Ausnahme repräsentiert wird.

COMException::HResult-Eigenschaft

Das HRESULT, das der Ausnahme entspricht.

Syntax

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

Eigenschaftswert

Ein HRESULT-Wert, der den Fehler angibt.

Hinweise

Weitere Informationen zum Interpretieren des HRESULT-Werts finden Sie unter Struktur der COM-Fehlercodes.

COMException::Message-Eigenschaft

Meldung, in der die Ausnahme beschrieben wird.

Syntax

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

Eigenschaftswert

Eine Beschreibung der Ausnahme.

Siehe auch

Plattformnamespace