Platform::COMException (classe)

Rappresenta errori COM che si verificano durante l'esecuzione dell'applicazione. COMException è la classe di base per un set di eccezioni standard predefinite.

Sintassi

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

Membri

La classe COMException eredita dalla classe Object e dalle interfacce IException, IPrintable e IEquatable.

COMException include anche i seguenti tipi di membri.

Costruttori

Membro	Descrizione
COMException	Inizializza una nuova istanza della classe COMException.

Metodi

La classe COMException eredita i metodi Equals(), Finalize(), GetHashCode(), GetType(), MemberwiseClose() e ToString() da Platform::Object Class.

Proprietà

La classe COMException presenta le proprietà seguenti:

Membro	Descrizione
Eccezione::HResult	Valore HRESULT corrispondente all'eccezione.
Eccezione::Message	Messaggio in cui viene descritta l'eccezione.

Eccezioni derivate

Le seguenti eccezioni predefinite sono derivate da COMException. Differiscono da COMException solo nel nome, nel nome del costruttore e nel valore di HRESULT sottostante.

Nome	HRESULT sottostante	Descrizione
COMException	HRESULT definito dall'utente	Generata quando viene restituito un HRESULT non riconosciuto da una chiamata a un metodo COM.
AccessDeniedException	E_ACCESSDENIED	Generata quando viene negato l'accesso a una risorsa o a una funzionalità.
ChangedStateException	E_CHANGED_STATE	Generata quando i metodi di un iteratore di raccolta o di una visualizzazione di raccolta vengono chiamati dopo che la raccolta padre è stata modificata, invalidando così i risultati del metodo.
ClassNotRegisteredException	REGDB_E_CLASSNOTREG	Generata quando una classe COM non è stata registrata.
DisconnectedException	RPC_E_DISCONNECTED	Generata quando un oggetto viene disconnesso dai relativi client.
FailureException	E_FAIL	Generata quando un'operazione non viene completata correttamente.
InvalidArgumentException	E_INVALIDARG	Generata quando uno degli argomenti forniti a un metodo non è valido.
InvalidCastException	E_NOINTERFACE	Generata quando non è possibile eseguire il cast di un tipo a un altro tipo.
NotImplementedException	E_NOTIMPL	Generata se un metodo di interfaccia non è stato implementato in una classe.
NullReferenceException	E_POINTER	Generata quando viene effettuato un tentativo di dereferenziare un riferimento di oggetto null.
OperationCanceledException	E_ABORT	Generata quando un'operazione viene interrotta.
OutOfBoundsException	E_BOUNDS	Generata quando un'operazione tenta di accedere a dati memorizzati al di fuori dell'intervallo valido.
OutOfMemoryException	E_OUTOFMEMORY	Generata quando la memoria disponibile non è sufficiente per completare l'operazione.

Requisiti

Client minimo supportato: Windows 8

Server minimo supportato: Windows Server 2012

Spazio dei nomi: Platform

Metadati: platform.winmd

Costruttore COMException::COMException

Inizializza una nuova istanza della classe COMException.

Sintassi

COMException(int hresult);

Parametri

hresult
Errore HRESULT rappresentato dall'eccezione.

Proprietà COMException::HResult

Valore HRESULT corrispondente all'eccezione.

Sintassi

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

Valore della proprietà

Valore HRESULT che specifica l'errore.

Osservazioni:

Per altre informazioni su come interpretare il valore HRESULT, vedere Struttura dei codici di errore COM.

Proprietà COMException::Message

Messaggio in cui viene descritta l'eccezione.

Sintassi

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

Valore della proprietà

Descrizione dell'eccezione.

Vedi anche

Spazio dei nomi Platform