Marshal.GetExceptionForHR Méthode

Définition

Espace de noms:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Convertit un code d'erreur HRESULT en objet Exception correspondant.

Surcharges

GetExceptionForHR(Int32)	Convertit le code d’erreur HRESULT spécifié en objet Exception correspondant.
GetExceptionForHR(Int32, IntPtr)	Convertit le code d’erreur HRESULT spécifié en objet Exception correspondant, avec des informations supplémentaires sur l’erreur passées dans une interface IErrorInfo pour l’objet exception.

GetExceptionForHR(Int32)

Source:

Marshal.cs

Convertit le code d’erreur HRESULT spécifié en objet Exception correspondant.

public:
 static Exception ^ GetExceptionForHR(int errorCode);

public static Exception? GetExceptionForHR (int errorCode);

static member GetExceptionForHR : int -> Exception

Public Shared Function GetExceptionForHR (errorCode As Integer) As Exception

Paramètres

errorCode

Int32

HRESULT à convertir.

Retours

Exception

Objet qui représente le HRESULT converti, ou null si la valeur HRESULT ne représente pas un code d’erreur (par exemple, S_OK et S_FALSE).

Remarques

Utilisez la GetExceptionForHR méthode pour obtenir un Exception basé sur un HRESULT sans avoir à appeler la ThrowExceptionForHR méthode et intercepter l’exception.

L’interface IErrorInfo actuelle est utilisée pour construire l’exception.

Pour le mappage de chaque HRESULT à sa classe d’exception comparable dans le .NET Framework, consultez Guide pratique pour mapper les HRESULT et exceptions.

Voir aussi

• ThrowExceptionForHR
• IErrorInfo Interface

GetExceptionForHR(Int32, IntPtr)

Source:

Marshal.cs

Convertit le code d’erreur HRESULT spécifié en objet Exception correspondant, avec des informations supplémentaires sur l’erreur passées dans une interface IErrorInfo pour l’objet exception.

public:
 static Exception ^ GetExceptionForHR(int errorCode, IntPtr errorInfo);

public static Exception? GetExceptionForHR (int errorCode, IntPtr errorInfo);

static member GetExceptionForHR : int * nativeint -> Exception

Public Shared Function GetExceptionForHR (errorCode As Integer, errorInfo As IntPtr) As Exception

Paramètres

errorCode

Int32

HRESULT à convertir.

errorInfo

IntPtr

nativeint

Pointeur vers l’interface IErrorInfo qui fournit plus d’informations sur l’erreur. Vous pouvez spécifier IntPtr(0) pour utiliser l’interface IErrorInfo actuelle ou IntPtr(-1) pour ignorer l’interface IErrorInfo actuelle et construire l’exception uniquement à partir du code d’erreur.

Retours

Exception

Objet qui représente le HRESULT converti et les informations obtenues de errorInfo, ou null si la valeur HRESULT ne représente pas un code d’erreur (par exemple, S_OK et S_FALSE).

Remarques

Utilisez la GetExceptionForHR méthode pour obtenir un Exception basé sur un HRESULT sans avoir à appeler la ThrowExceptionForHR méthode et intercepter l’exception (évitant ainsi la surcharge de performances correspondante). Le errorInfo paramètre fournit des informations supplémentaires sur l’erreur, telles que sa description textuelle et l’identificateur global unique (GUID) pour l’interface qui a défini l’erreur.

Utilisez cette surcharge de méthode si vous avez des informations d’erreur personnalisées que vous devez fournir dans la conversion.

Pour le mappage de chaque HRESULT à sa classe d’exception comparable dans le .NET Framework, consultez Guide pratique pour mapper les HRESULT et exceptions.

Voir aussi

• ThrowExceptionForHR
• IErrorInfo Interface