Platform::COMException (classe)
Représente les erreurs COM qui se produisent lors de l'exécution de l'application. COMException est la classe de base pour un jeu d'exceptions prédéfinies et standard.
Syntaxe
public ref class COMException : Exception, IException, IPrintable, IEquatable
Membres
La classe COMException hérite de la classe d'objets et des interfaces IException, IPrintable et IEquatable.
COMException a également les types de membre suivants.
Constructeurs
| Membre | Description |
|---|---|
| COMException | Initialise une nouvelle instance de la classe COMException. |
Méthodes
La classe COMException hérite des méthodes Equals(), Finalize(), GetHashCode(), GetType(), MemberwiseClose() et ToString() de Platform::Object Class.
Propriétés
La classe COMException a les propriétés ci-dessous.
| Membre | Description |
|---|---|
| Exception ::HResult | HRESULT qui correspond à l'exception. |
| Exception ::Message | Message décrivant l'exception. |
Exceptions dérivées
Les exceptions prédéfinies suivantes sont dérivées de COMException. Elles diffèrent de COMException uniquement au niveau de leur nom, du nom de leur constructeur et de leur valeur HRESULT sous-jacente.
| Nom | HRESULT sous-jacent | Description |
|---|---|---|
| COMException | hresult défini par l’utilisateur | Levée lorsqu'un HRESULT non reconnu est retourné d'un appel de méthode COM. |
| AccessDeniedException | E_ACCESSDENIED | Levée lorsque l'accès est refusé à une ressource ou à une fonctionnalité. |
| ChangedStateException | E_CHANGED_STATE | Levée lorsque les méthodes d'un itérateur de collection ou d'une vue de collection sont appelées après la modification d'une collection parente, invalidant les résultats de la méthode. |
| ClassNotRegisteredException | REGDB_E_CLASSNOTREG | Levée lorsqu'une classe COM n'a pas été inscrite. |
| DisconnectedException | RPC_E_DISCONNECTED | Levée lorsqu'un objet est déconnecté de ses clients. |
| FailureException | E_FAIL | Levée lorsqu'une opération échoue. |
| InvalidArgumentException | E_INVALIDARG | Levée lorsque l'un des arguments fournis à une méthode n'est pas valide. |
| InvalidCastException | E_NOINTERFACE | Levée lorsqu'un type ne peut pas être casté en un autre type. |
| NotImplementedException | E_NOTIMPL | Levée si une méthode d'interface n'a pas été implémentée pour une classe. |
| NullReferenceException | E_POINTER | Levée lors d'une tentative de suppression de la référence à une référence d'objet null. |
| OperationCanceledException | E_ABORT | Levée lorsqu'une opération est abandonnée. |
| OutOfBoundsException | E_BOUNDS | Levée lorsqu'une opération tente d'accéder aux données en dehors de la plage valide. |
| OutOfMemoryException | E_OUTOFMEMORY | Levée en cas de mémoire insuffisante pour terminer l'opération. |
Spécifications
Client minimum pris en charge : Windows 8
Serveur minimum pris en charge : Windows Server 2012
Espace de noms : Platform
Métadonnées : platform.winmd
COMException::COMException, constructeur
Initialise une nouvelle instance de la classe COMException.
Syntaxe
COMException( int hresult )
Paramètres
hresult
Erreur HRESULT qui est représentée par l'exception.
COMException::HResult, propriété
HRESULT qui correspond à l'exception.
Syntaxe
public:
property int HResult { int get();}
Valeur de propriété
Valeur HRESULT qui spécifie l'erreur.
Notes
Pour plus d’informations sur l’interprétation de la valeur HRESULT, consultez Structure des codes d’erreur COM.
COMException::Message, propriété
Message décrivant l'exception.
Syntaxe
public:property String^ Message { String^ get();}
Valeur de propriété
Description de l'exception.