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.