Freigeben über


Marshal.GetExceptionForHR Methode

Definition

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 -> Exception
static member GetExceptionForHR : int -> Exception
Public Shared Function GetExceptionForHR (errorCode As Integer) As Exception

Parameter

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 -> Exception
static member GetExceptionForHR : int * nativeint -> Exception
Public Shared Function GetExceptionForHR (errorCode As Integer, errorInfo As IntPtr) As Exception

Parameter

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.

Weitere Informationen

Gilt für: