Platform::COMException (classe)

  • Articolo

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