Marshal.GetExceptionForHR Méthode

Définition

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)

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

public:
 static Exception ^ GetExceptionForHR(int errorCode);
[System.Security.SecurityCritical]
public static Exception GetExceptionForHR (int errorCode);
public static Exception? GetExceptionForHR (int errorCode);
public static Exception GetExceptionForHR (int errorCode);
[<System.Security.SecurityCritical>]
static member GetExceptionForHR : int -> Exception
static member GetExceptionForHR : int -> Exception
Public Shared Function GetExceptionForHR (errorCode As Integer) As Exception

Paramètres

errorCode
Int32

HRESULT à convertir.

Retours

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).

Attributs

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

S’applique à

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.

public:
 static Exception ^ GetExceptionForHR(int errorCode, IntPtr errorInfo);
[System.Security.SecurityCritical]
public static Exception GetExceptionForHR (int errorCode, IntPtr errorInfo);
public static Exception? GetExceptionForHR (int errorCode, IntPtr errorInfo);
public static Exception GetExceptionForHR (int errorCode, IntPtr errorInfo);
[<System.Security.SecurityCritical>]
static member GetExceptionForHR : int * nativeint -> Exception
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

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).

Attributs

Remarques

Utilisez la GetExceptionForHR méthode pour obtenir un Exception basé sur un HRESULT sans avoir à appeler la méthode et intercepter l’exception ThrowExceptionForHR (é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

S’applique à