Plattform::COMException-klass
Representerar COM-fel som inträffar under programkörningen. COMException är basklassen för en uppsättning fördefinierade standardundantag.
Syntax
public ref class COMException : Exception, IException, IPrintable, IEquatable
Medlemmar
COMException-klassen ärver från klassen Object och gränssnitten IException, IPrintable och IEquatable.
COMException har också följande typer av medlemmar.
konstruktorer
| Medlem | Beskrivning |
|---|---|
| COMException | Initierar en ny instans av COMException-klassen. |
metoder
COMException-klassen ärver metoderna Equals(), Finalize(), GetHashCode(), GetType(), MemberwiseClose() och ToString() från Platform::Object Class.
Egenskaper
COMException-klassen har följande egenskaper.
| Medlem | Beskrivning |
|---|---|
| Undantag::HResult | HRESULT som motsvarar undantaget. |
| undantag::Meddelande | Meddelande som beskriver undantaget. |
Härledda undantag
Följande fördefinierade undantag härleds från COMException. De skiljer sig endast från COMException i deras namn, namnet på konstruktorn och deras underliggande HRESULT-värde.
| Namn | Underliggande HRESULT | Beskrivning |
|---|---|---|
| COMException | användardefinierad hresult- | Utlöses när en okänd HRESULT returneras från ett COM-metodanrop. |
| AccessDeniedException | E_ACCESSDENIED | Genereras när åtkomst nekas till en resurs eller funktion. |
| ChangedStateException | E_CHANGED_STATE | Utlöses när metoder för en samlingsiterator eller en samlingsvy anropas efter att den överordnade samlingen har ändrats, vilket ogiltigförklarar resultatet av metoden. |
| ClassNotRegisteredException | REGDB_E_CLASSNOTREG | Utlöses när en COM-klass inte har registrerats. |
| DisconnectedException | RPC_E_DISCONNECTED | Utlöses när ett objekt kopplas från från sina klienter. |
| FailureException | E_FAIL | Utlöses när en åtgärd misslyckas. |
| InvalidArgumentException | E_INVALIDARG | Utlöses när ett av argumenten som tillhandahålls till en metod inte är giltigt. |
| InvalidCastException | E_NOINTERFACE | Utlöses när en typ inte kan kastas till en annan typ. |
| NotImplementedException | E_NOTIMPL | Utlöses om en gränssnittsmetod inte har implementerats på en klass. |
| NullReferenceException | E_POINTER | Utlöses när det görs ett försök att avrefereras en null-objektreferens. |
| OperationCanceledException | E_ABORT | Utlöses när en åtgärd avbryts. |
| OutOfBoundsException | E_BOUNDS | Utlöses när en åtgärd försöker komma åt data utanför det giltiga intervallet. |
| OutOfMemoryException | E_OUTOFMEMORY | Utlöses när det inte finns tillräckligt med minne för att slutföra åtgärden. |
Krav
Lägsta klient som stöds: Windows 8
Lägsta server som stöds: Windows Server 2012
Namnområde: Platform
metadata: platform.winmd
COMException::COMException Constructor
Intialiserar en ny instans av COMException-klassen.
Syntax
COMException(int hresult);
Parametrar
hresult
Felet HRESULT som representeras av undantaget.
COMException::HResult-egenskap
HRESULT som motsvarar undantaget.
Syntax
public:
property int HResult { int get(); }
Egenskapsvärde
Ett HRESULT-värde som anger felet.
Anmärkningar
Mer information om hur du tolkar HRESULT-värdet finns i Struktur för COM-felkoder.
COMException::Message Property
Meddelande som beskriver undantaget.
Syntax
public:
property String^ Message { String^ get(); }
Egenskapsvärde
En beskrivning av undantaget.