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: Bahnsteig

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