Marshal.GetExceptionForHR Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Konvertiert einen HRESULT-Fehlercode in ein entsprechendes Exception-Objekt.
Überlädt
| GetExceptionForHR(Int32) |
Konvertiert den angegebenen HRESULT-Fehlercode in ein entsprechendes Exception-Objekt. |
| GetExceptionForHR(Int32, IntPtr) |
Konvertiert den angegebenen HRESULT-Fehlercode in ein entsprechendes Exception-Objekt, wobei zusätzliche Fehlerinformationen für das Ausnahmeobjekt in eine IErrorInfo-Schnittstelle übergeben werden. |
GetExceptionForHR(Int32)
- Quelle:
- Marshal.cs
- Quelle:
- Marshal.cs
- Quelle:
- Marshal.cs
Konvertiert den angegebenen HRESULT-Fehlercode in ein entsprechendes Exception-Objekt.
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 -> Exceptionstatic member GetExceptionForHR : int -> ExceptionPublic Shared Function GetExceptionForHR (errorCode As Integer) As ExceptionParameter
- errorCode
- Int32
Das zu konvertierende HRESULT.
Gibt zurück
Ein Objekt, das den konvertierten HRESULT-Wert darstellt, oder null, wenn der HRESULT-Wert keinen Fehlercode darstellt (z.B. S_OK oder S_FALSE).
- Attribute
Hinweise
Verwenden Sie die GetExceptionForHR -Methode, um basierend Exception auf einem HRESULT-Wert zu erhalten, ohne die ThrowExceptionForHR -Methode aufrufen und die Ausnahme abfangen zu müssen.
Die aktuelle IErrorInfo-Schnittstelle wird verwendet, um die Ausnahme zu erstellen.
Informationen zur Zuordnung von jedem HRESULT zu seiner vergleichbaren Ausnahmeklasse in .NET Framework finden Sie unter Vorgehensweise: Zuordnen von HRESULTs und Ausnahmen.
Weitere Informationen
Gilt für:
GetExceptionForHR(Int32, IntPtr)
- Quelle:
- Marshal.cs
- Quelle:
- Marshal.cs
- Quelle:
- Marshal.cs
Konvertiert den angegebenen HRESULT-Fehlercode in ein entsprechendes Exception-Objekt, wobei zusätzliche Fehlerinformationen für das Ausnahmeobjekt in eine IErrorInfo-Schnittstelle übergeben werden.
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 -> Exceptionstatic member GetExceptionForHR : int * nativeint -> ExceptionPublic Shared Function GetExceptionForHR (errorCode As Integer, errorInfo As IntPtr) As ExceptionParameter
- errorCode
- Int32
Das zu konvertierende HRESULT.
- errorInfo
-
IntPtr
nativeint
Ein Zeiger auf die IErrorInfo-Schnittstelle, die weitere Informationen über den Fehler bereitstellt. Sie können IntPtr(0) angeben, um die aktuelle IErrorInfo -Schnittstelle zu verwenden, oder Sie können IntPtr(-1) angeben, um die aktuelle IErrorInfo -Schnittstelle zu ignorieren und die Ausnahme direkt aus dem Fehlercode zu erstellen.
Gibt zurück
Ein Objekt, das den konvertierten HRESULT-Wert und von errorInfo abgerufene Informationen darstellt, oder null, wenn ein HRESULT-Wert keinen Fehlercode darstellt (z.B. S_OK oder S_FALSE).
- Attribute
Hinweise
Verwenden Sie die GetExceptionForHR -Methode, um eine Exception auf einem HRESULT basierende methode abzurufen, ohne die ThrowExceptionForHR -Methode aufrufen und die Ausnahme abfangen zu müssen (wodurch der entsprechende Leistungsaufwand vermieden wird). Der errorInfo Parameter stellt zusätzliche Informationen zum Fehler bereit, z. B. die Textbeschreibung und die GUID (Globally Unique Identifier) für die Schnittstelle, die den Fehler definiert hat.
Verwenden Sie diese Methodenüberladung, wenn Sie benutzerdefinierte Fehlerinformationen haben, die Sie bei der Konvertierung angeben müssen.
Informationen zur Zuordnung von jedem HRESULT zu seiner vergleichbaren Ausnahmeklasse in .NET Framework finden Sie unter Vorgehensweise: Zuordnen von HRESULTs und Ausnahmen.
