Platform::COMException – třída
Představuje chyby modelu COM, ke kterým dochází během provádění aplikace. COMException je základní třída pro sadu předdefinovaných standardních výjimek.
Syntaxe
public ref class COMException : Exception, IException, IPrintable, IEquatable
Členové
COMException třída dědí z Object třídy a IException, IPrintable a IEquatable rozhraní.
ComException má také následující typy členů.
Konstruktory
| Člen | Popis |
|---|---|
| Výjimka MODELU COM | Inicializuje novou instanci COMException třídy. |
Metody
ComException třída dědí Equals(), Finalize(), GetHashCode(), GetType(), MemberwiseClose() a ToString() metody z Třídy Platform::Object.
Vlastnosti
ComException třída má následující vlastnosti.
| Člen | Popis |
|---|---|
| Výjimka::HResult | HRESULT, která odpovídá výjimce. |
| Výjimka::Zpráva | Zpráva, která popisuje výjimku. |
Odvozené výjimky
Následující předdefinované výjimky jsou odvozeny z modelu COMException. Liší se od modelu COMException pouze v jejich názvu, názvu jejich konstruktoru a jejich podkladové hodnotě HRESULT.
| Název | Podkladová hodnota HRESULT | Popis |
|---|---|---|
| Výjimka MODELU COM | uživatelem definovaný hresult | Vyvolá se, když se z volání metody COM vrátí nerozpoznaná hodnota HRESULT. |
| AccessDeniedException | E_ACCESSDENIED | Vyvolá se při odepření přístupu k prostředku nebo funkci. |
| ChangedStateException | E_CHANGED_STATE | Vyvolá se při vyvolání metod iterátoru kolekce nebo zobrazení kolekce po změně nadřazené kolekce a zneplatnění výsledků metody. |
| ClassNotRegisteredException | REGDB_E_CLASSNOTREG | Vyvolá se, když nebyla zaregistrována třída MODELU COM. |
| DisconnectedException | RPC_E_DISCONNECTED | Vyvolá se při odpojení objektu od klientů. |
| FailureException | E_FAIL | Vyvolá se při selhání operace. |
| InvalidArgumentException | E_INVALIDARG | Vyvolá se, když některý z argumentů zadaný pro metodu není platný. |
| InvalidCastException | E_NOINTERFACE | Vyvolá se, když typ nelze přetypovat na jiný typ. |
| NotImplementedException | E_NOTIMPL | Vyvolá se, pokud metoda rozhraní nebyla implementována ve třídě. |
| NullReferenceException | E_POINTER | Vyvolá se, když dojde k pokusu o dereference odkaz na objekt null. |
| OperationCanceledException | E_ABORT | Vyvolá se při přerušení operace. |
| OutOfBoundsException | E_BOUNDS | Vyvolá se, když se operace pokusí o přístup k datům mimo platný rozsah. |
| OutOfMemoryException | E_OUTOFMEMORY | Vyvolá se, když není dostatek paměti k dokončení operace. |
Požadavky
Minimální podporovaný klient: Windows 8
Minimální podporovaný server: Windows Server 2012
Obor názvů: Platforma
Metadata: platform.winmd
COMException::COMException – konstruktor
Inicializuje novou instanci COMException třídy.
Syntaxe
COMException( int hresult )
Parametry
hresult
Chyba HRESULT reprezentovaná výjimkou.
COMException::HResult – vlastnost
HRESULT, která odpovídá výjimce.
Syntaxe
public:
property int HResult { int get();}
Hodnota vlastnosti
Hodnota HRESULT, která určuje chybu.
Poznámky
Další informace o tom, jak interpretovat hodnotu HRESULT naleznete v tématu Struktura kódů chyb modelu COM.
COMException::Message – vlastnost
Zpráva, která popisuje výjimku.
Syntaxe
public:property String^ Message { String^ get();}
Hodnota vlastnosti
Popis výjimky.