Marshal.GetExceptionForHR Methode

Definition

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

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

Konvertiert den angegebenen HRESULT-Fehlercode in ein entsprechendes Exception-Objekt.

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

Parameter

errorCode

Int32

Das zu konvertierende HRESULT.

Gibt zurück

Exception

Ein Objekt, das den konvertierten HRESULT-Wert darstellt, oder null, wenn der HRESULT-Wert keinen Fehlercode darstellt (z.B. S_OK oder S_FALSE).

Hinweise

Verwenden Sie die GetExceptionForHR -Methode, um basierend Exception auf einem HRESULT eine abzurufen, 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 im .NET Framework finden Sie unter Vorgehensweise: Zuordnen von HRESULTs und Ausnahmen.

Weitere Informationen

• ThrowExceptionForHR
• IErrorInfo-Schnittstelle

GetExceptionForHR(Int32, IntPtr)

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

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

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

Exception

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

Hinweise

Verwenden Sie die GetExceptionForHR -Methode, um basierend Exception auf einem HRESULT eine abzurufen, ohne die ThrowExceptionForHR -Methode aufrufen und die Ausnahme abfangen zu müssen (wodurch der entsprechende Leistungsmehraufwand 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 im .NET Framework finden Sie unter Vorgehensweise: Zuordnen von HRESULTs und Ausnahmen.

Weitere Informationen

• ThrowExceptionForHR
• IErrorInfo-Schnittstelle