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.