Marshal.GetExceptionForHR Methode

Definition

Namespace:: System.Runtime.InteropServices

Assemblys:: mscorlib.dll, System.Runtime.InteropServices.dll

Assemblys:: netstandard.dll, System.Runtime.InteropServices.dll

Assembly:: System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

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

Name	Beschreibung
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 in einer IErrorInfo-Schnittstelle für das Ausnahmeobjekt übergeben werden.
GetExceptionForHR(Int32, Guid, IntPtr)

GetExceptionForHR(Int32)

Quelle:: Marshal.cs

Quelle:: Marshal.cs

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

Exception

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

Attribute: SecurityCriticalAttribute

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.

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 How to: Map HRESULTs and Exceptions.

Weitere Informationen

Gilt für:

GetExceptionForHR(Int32, IntPtr)

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Konvertiert den angegebenen HRESULT-Fehlercode in ein entsprechendes Exception Objekt, wobei zusätzliche Fehlerinformationen in einer IErrorInfo-Schnittstelle für das Ausnahmeobjekt ü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 Schnittstelle, die IErrorInfo weitere Informationen zum Fehler bereitstellt. Sie können angeben IntPtr(0) , dass die aktuelle IErrorInfo Schnittstelle verwendet oder IntPtr(-1) die aktuelle IErrorInfo Schnittstelle ignoriert und die Ausnahme nur aus dem Fehlercode erstellt wird.

Gibt zurück

Exception

Ein Objekt, das das konvertierte HRESULT und informationen darstellt, aus errorInfodenen abgerufen wird, oder null wenn ein HRESULT-Wert keinen Fehlercode darstellt (z S_OK . B. oder S_FALSE).

Attribute: SecurityCriticalAttribute

Hinweise

Verwenden Sie die GetExceptionForHR Methode, um eine Exception auf einem HRESULT basierende Methode abzurufen, ohne die ThrowExceptionForHR Methode aufrufen zu müssen und die Ausnahme abzufangen (wodurch der entsprechende Leistungsaufwand vermieden wird). Der errorInfo Parameter liefert zusätzliche Informationen zum Fehler, z. B. seine 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 in der Konvertierung angeben müssen.

Informationen zur Zuordnung von jedem HRESULT zu seiner vergleichbaren Ausnahmeklasse im .NET Framework finden Sie unter How to: Map HRESULTs and Exceptions.

Weitere Informationen

Gilt für:

GetExceptionForHR(Int32, Guid, IntPtr)

Quelle:: Marshal.cs

Quelle:: Marshal.cs

public:
 static Exception ^ GetExceptionForHR(int errorCode, Guid % iid, IntPtr pUnk);

public static Exception? GetExceptionForHR(int errorCode, in Guid iid, IntPtr pUnk);

static member GetExceptionForHR : int * Guid * nativeint -> Exception

Public Shared Function GetExceptionForHR (errorCode As Integer, ByRef iid As Guid, pUnk As IntPtr) As Exception

Parameter

errorCode: Int32

iid: Guid

pUnk: IntPtr
nativeint

Gibt zurück

Exception

Gilt für:

Feedback

War diese Seite hilfreich?