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.