Marshal.GetExceptionForHR Metoda

Definice

Obor názvů:

System.Runtime.InteropServices

Sestavení:

System.Runtime.InteropServices.dll

Převede kód chyby HRESULT na odpovídající Exception objekt.

Přetížení

GetExceptionForHR(Int32)	Převede zadaný kód chyby HRESULT na odpovídající Exception objekt.
GetExceptionForHR(Int32, IntPtr)	Převede zadaný kód chyby HRESULT na odpovídající Exception objekt s dalšími informacemi o chybě předané v rozhraní IErrorInfo pro objekt výjimky.

GetExceptionForHR(Int32)

Zdroj:

Marshal.cs

Převede zadaný kód chyby HRESULT na odpovídající 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

Parametry

errorCode

Int32

Hodnota HRESULT, která se má převést.

Návraty

Exception

Objekt, který představuje převedenou hodnotu HRESULT nebo null pokud hodnota HRESULT nepředstavuje kód chyby (například S_OK nebo S_FALSE).

Poznámky

GetExceptionForHR Pomocí metody získejte metodu Exception na základě hodnoty HRESULT, aniž byste museli volat metodu ThrowExceptionForHR a zachytit výjimku.

Aktuální IErrorInfo rozhraní slouží k vytvoření výjimky.

Mapování z jednotlivých hodnot HRESULT na jeho srovnatelnou třídu výjimek v rozhraní .NET Framework naleznete v tématu Postupy: Mapování HRESULT a výjimek.

Viz také

• ThrowExceptionForHR
• IErrorInfo – rozhraní

GetExceptionForHR(Int32, IntPtr)

Zdroj:

Marshal.cs

Převede zadaný kód chyby HRESULT na odpovídající Exception objekt s dalšími informacemi o chybě předané v rozhraní IErrorInfo pro objekt výjimky.

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

Parametry

errorCode

Int32

Hodnota HRESULT, která se má převést.

errorInfo

IntPtr

nativeint

Ukazatel na IErrorInfo rozhraní, které poskytuje další informace o chybě. Můžete určit IntPtr(0) použití aktuálního IErrorInfo rozhraní, nebo IntPtr(-1) ignorovat aktuální IErrorInfo rozhraní a vytvořit výjimku pouze z kódu chyby.

Návraty

Exception

Objekt, který představuje převedenou hodnotu HRESULT a informace získané z errorInfo, nebo null pokud hodnota HRESULT nepředstavuje kód chyby (například S_OK nebo S_FALSE).

Poznámky

GetExceptionForHR Pomocí metody získejte metodu Exception na základě hodnoty HRESULT, aniž byste museli volat metodu ThrowExceptionForHR a zachytit výjimku (čímž se vyhnete odpovídající režii na výkon). Parametr errorInfo poskytuje další informace o chybě, například jeho textový popis a globálně jedinečný identifikátor (GUID) pro rozhraní, které chybu definovalo.

Toto přetížení metody použijte, pokud máte vlastní informace o chybě, které musíte zadat v převodu.

Mapování z jednotlivých hodnot HRESULT na jeho srovnatelnou třídu výjimek v rozhraní .NET Framework naleznete v tématu Postupy: Mapování HRESULT a výjimek.

Viz také

• ThrowExceptionForHR
• IErrorInfo – rozhraní