Platform::COMException, klasa

Reprezentuje błędy COM występujące podczas wykonywania aplikacji. COMException to klasa bazowa dla zestawu wstępnie zdefiniowanych, standardowych wyjątków.

Składnia

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

Elementy członkowskie

Klasa COMException dziedziczy z klasy Object i interfejsów IException, IPrintable i IEquatable.

Wyjątek COMException ma również następujące typy elementów członkowskich.

Konstruktory

Element członkowski	opis
ComException	Inicjuje nowe wystąpienie klasy COMException.

Metody

Klasa COMException dziedziczy metody Equals(), Finalize(), GetHashCode(), GetType(), MemberwiseClose() i ToString() z klasy Platform::Object.

Właściwości

Klasa COMException ma następujące właściwości.

Element członkowski	opis
Exception::HResult	HRESULT, który odpowiada wyjątkowi.
Exception::Message	Komunikat opisujący wyjątek.

Wyjątki pochodne

Następujące wstępnie zdefiniowane wyjątki pochodzą z modelu COMException. Różnią się one od modelu COMException tylko w nazwie, nazwie konstruktora i podstawowej wartości HRESULT.

Nazwisko	Podstawowy hrESULT	opis
ComException	hresult zdefiniowany przez użytkownika	Zgłaszany, gdy nierozpoznany HRESULT jest zwracany z wywołania metody COM.
AccessDeniedException	E_ACCESSDENIED	Zgłaszany, gdy odmowa dostępu do zasobu lub funkcji.
ChangedStateException	E_CHANGED_STATE	Zgłaszany, gdy metody iteratora kolekcji lub widoku kolekcji są wywoływane po zmianie kolekcji nadrzędnej, unieważniając wyniki metody.
ClassNotRegisteredException	REGDB_E_CLASSNOTREG	Zgłaszany, gdy klasa COM nie została zarejestrowana.
DisconnectedException	RPC_E_DISCONNECTED	Zgłaszany, gdy obiekt jest odłączony od swoich klientów.
BłądException	E_FAIL	Zgłaszany, gdy operacja kończy się niepowodzeniem.
InvalidArgumentException	E_INVALIDARG	Zgłaszany, gdy jeden z argumentów podanych w metodzie jest nieprawidłowy.
InvalidCastException	E_NOINTERFACE	Zgłaszany, gdy nie można rzutować typu na inny typ.
NotImplementedException	E_NOTIMPL	Zgłaszany, jeśli metoda interfejsu nie została zaimplementowana w klasie.
NullReferenceException	E_POINTER	Zgłaszany podczas próby wyłudzenia odwołania do obiektu o wartości null.
OperationCanceledException	E_ABORT	Zgłaszany po przerwaniu operacji.
OutOfBoundsException	E_BOUNDS	Zgłaszany, gdy operacja próbuje uzyskać dostęp do danych poza prawidłowym zakresem.
OutOfMemoryException	E_OUTOFMEMORY	Zgłaszany, gdy nie ma wystarczającej ilości pamięci do ukończenia operacji.

Wymagania

Minimalny obsługiwany klient: Windows 8

Minimalny obsługiwany serwer: Windows Server 2012

Przestrzeń nazw: Platforma

Metadane: platform.winmd

COMException::COMException, konstruktor

Intializuje nowe wystąpienie klasy COMException.

Składnia

COMException(int hresult);

Parametry

hresult
Błąd HRESULT reprezentowany przez wyjątek.

COMException::HResult, właściwość

HRESULT, który odpowiada wyjątkowi.

Składnia

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

Wartość właściwości

Wartość HRESULT określająca błąd.

Uwagi

Aby uzyskać więcej informacji na temat interpretowania wartości HRESULT, zobacz Struktura kodów błędów COM.

COMException::Message, właściwość

Komunikat opisujący wyjątek.

Składnia

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

Wartość właściwości

Opis wyjątku.

Zobacz też

Przestrzeń nazw platformy