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í objekt Exception.

Přetížení

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

GetExceptionForHR(Int32)

Zdroj:

Marshal.cs

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

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

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

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

Mapování z každého HRESULT na svou srovnatelnou třídu výjimek v rozhraní .NET Framework naleznete v tématu Postupy: Mapování HRESULT a výjimek.

Viz také

• ThrowExceptionForHR
• rozhraní IErrorInfo

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ředávané 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 rozhraní IErrorInfo, které poskytuje další informace o chybě. Můžete určit, IntPtr(0) použít aktuální rozhraní IErrorInfo, nebo IntPtr(-1) ignorovat aktuální rozhraní IErrorInfo a vytvořit výjimku pouze z kódu chyby.

Návraty

Exception

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

Poznámky

Pomocí metody GetExceptionForHR získejte Exception na základě hodnoty HRESULT, aniž byste museli volat metodu ThrowExceptionForHR a zachytit výjimku (tím se vyhnout odpovídající režii na výkon). Parametr errorInfo poskytuje další informace o chybě, například její 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ách, které musíte zadat v převodu.

Mapování z každého HRESULT na svou srovnatelnou třídu výjimek v rozhraní .NET Framework naleznete v tématu Postupy: Mapování HRESULT a výjimek.

Viz také

• ThrowExceptionForHR
• rozhraní IErrorInfo