Marshal.GetExceptionForHR Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Convertit un code d’erreur HRESULT en objet correspondant Exception .
Surcharges
| Nom | Description |
|---|---|
| GetExceptionForHR(Int32) |
Convertit le code d’erreur HRESULT spécifié en objet correspondant Exception . |
| GetExceptionForHR(Int32, IntPtr) |
Convertit le code d’erreur HRESULT spécifié en objet correspondant Exception , avec des informations d’erreur supplémentaires transmises dans une interface IErrorInfo pour l’objet d’exception. |
GetExceptionForHR(Int32)
Convertit le code d’erreur HRESULT spécifié en objet correspondant Exception .
public:
static Exception ^ GetExceptionForHR(int errorCode);[System.Security.SecurityCritical]
public static Exception GetExceptionForHR(int errorCode);public static Exception GetExceptionForHR(int errorCode);[<System.Security.SecurityCritical>]
static member GetExceptionForHR : int -> Exceptionstatic member GetExceptionForHR : int -> ExceptionPublic Shared Function GetExceptionForHR (errorCode As Integer) As ExceptionParamètres
- errorCode
- Int32
HRESULT à convertir.
Retours
Objet qui représente le HRESULT converti ou null si la valeur HRESULT ne représente pas de code d’erreur (par exemple, S_OK ou S_FALSE).
- Attributs
Remarques
Utilisez la GetExceptionForHR méthode pour obtenir un Exception HRESULT 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 framework .NET, consultez How to : Map HRESULTs and Exceptions.
Voir aussi
S’applique à
GetExceptionForHR(Int32, IntPtr)
Convertit le code d’erreur HRESULT spécifié en objet correspondant Exception , avec des informations d’erreur supplémentaires transmises dans une interface IErrorInfo pour l’objet d’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);[<System.Security.SecurityCritical>]
static member GetExceptionForHR : int * nativeint -> Exceptionstatic member GetExceptionForHR : int * nativeint -> ExceptionPublic Shared Function GetExceptionForHR (errorCode As Integer, errorInfo As IntPtr) As ExceptionParamè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) d’utiliser l’interface actuelle IErrorInfo ou IntPtr(-1) d’ignorer l’interface actuelle IErrorInfo et construire l’exception uniquement à partir du code d’erreur.
Retours
Objet qui représente le HRESULT converti et les informations obtenues à partir de errorInfo, ou null si une valeur HRESULT ne représente pas de code d’erreur (par exemple, S_OK ou S_FALSE).
- Attributs
Remarques
Utilisez la GetExceptionForHR méthode pour obtenir un Exception HRESULT basé sur un HRESULT sans avoir à appeler la ThrowExceptionForHR méthode et intercepter l’exception (ce qui évite 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) de 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 framework .NET, consultez How to : Map HRESULTs and Exceptions.