Marshal.GetExceptionForHR-Methode: (Int32, IntPtr)

  • Artikel

 

Veröffentlicht: Oktober 2016

Konvertiert den angegebenen HRESULT-Fehlercode in ein entsprechendes Exception-Objekt, wobei zusätzliche Fehlerinformationen in eine IErrorInfo-Schnittstelle für das Ausnahmeobjekt übergeben werden.

Namespace:   System.Runtime.InteropServices
Assembly:  mscorlib (in mscorlib.dll)

Syntax

[SecurityCriticalAttribute]
public static Exception GetExceptionForHR(
    int errorCode,
    IntPtr errorInfo
)

public:
[SecurityCriticalAttribute]
static Exception^ GetExceptionForHR(
    int errorCode,
    IntPtr errorInfo
)

[<SecurityCriticalAttribute>]
static member GetExceptionForHR : 
        errorCode:int *
        errorInfo:nativeint -> Exception

<SecurityCriticalAttribute>
Public Shared Function GetExceptionForHR (
    errorCode As Integer,
    errorInfo As IntPtr
) As Exception

Parameter

  • errorCode
    Type: System.Int32

    Das zu konvertierende HRESULT.

  • errorInfo
    Type: System.IntPtr

    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.

Rückgabewert

Type: System.Exception

Ein Objekt, das das konvertierte HRESULT und die aus errorInfo abgerufenen Informationen darstellt.

Hinweise

Verwenden der GetExceptionForHR -Methode zum Abrufen einer Exception basierend auf einem HRESULT ohne Aufruf der ThrowExceptionForHR -Methode und Abfangen der Ausnahme (daher vermieden werden die entsprechenden Systemleistung). Die errorInfo Parameter liefert zusätzliche Informationen über den Fehler, z. B. die Beschreibung und der global eindeutige Bezeichner (GUID) für die Schnittstelle, die den Fehler definiert.

Verwenden Sie Überladung dieser Methode, wenn Sie benutzerdefinierte Fehlerinformationen haben, die bei der Konvertierung angeben.

Für die Zuordnung von jedem HRESULT zu seiner vergleichbaren Ausnahmeklasse in .NET Framework finden Sie unter How to: Map HRESULTs and Exceptions.

Sicherheit

SecurityCriticalAttribute

requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.

Versionsinformationen

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 2.0
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Windows Phone Silverlight
Verfügbar seit 8.0
Windows Phone
Verfügbar seit 8.1

Siehe auch

ThrowExceptionForHR
GetExceptionForHR Überladen
Marshal-Klasse
System.Runtime.InteropServices-Namespace
IErrorInfo Interface

Zurück zum Anfang