Marshal.GetExceptionForHR Yöntem

Tanım

Ad Alanı:

System.Runtime.InteropServices

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.InteropServices.dll

HRESULT hata kodunu ilgili Exception nesneye dönüştürür.

Aşırı Yüklemeler

Name	Description
GetExceptionForHR(Int32)	Belirtilen HRESULT hata kodunu ilgili Exception nesnesine dönüştürür.
GetExceptionForHR(Int32, IntPtr)	Belirtilen HRESULT hata kodunu ilgili nesnesine dönüştürür ve özel durum nesnesi için IErrorInfo arabiriminde ek hata bilgileri geçirilir.
GetExceptionForHR(Int32, Guid, IntPtr)

GetExceptionForHR(Int32)

Kaynak:

Marshal.cs

Belirtilen HRESULT hata kodunu ilgili Exception nesnesine dönüştürür.

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

Parametreler

errorCode

Int32

Dönüştürülecek HRESULT.

Döndürülenler

Exception

Dönüştürülen HRESULT değerini temsil eden veya null HRESULT değeri bir hata kodunu (örneğin, veya S_OK) temsil etmiyorsa bir S_FALSE nesne.

Açıklamalar

GetExceptionForHR yöntemini çağırmak Exception ve özel durumu yakalamak zorunda kalmadan hresult tabanlı almak ThrowExceptionForHR için yöntemini kullanın.

Geçerli IErrorInfo arabirimi özel durumu oluşturmak için kullanılır.

her HRESULT'tan .NET Framework'teki karşılaştırılabilir özel durum sınıfına eşleme için bkz. H nasıl yapılır: HRESULTs ve Özel Durumları Eşleme.

Ayrıca bkz.

• ThrowExceptionForHR
• IErrorInfo Arabirimi

GetExceptionForHR(Int32, IntPtr)

Kaynak:

Marshal.cs

Belirtilen HRESULT hata kodunu ilgili nesnesine dönüştürür ve özel durum nesnesi için IErrorInfo arabiriminde ek hata bilgileri geçirilir.

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

Parametreler

errorCode

Int32

Dönüştürülecek HRESULT.

errorInfo

IntPtr

nativeint

Hata hakkında daha fazla bilgi sağlayan arabirim işaretçisi IErrorInfo . Geçerli arabirimi kullanmayı veya IntPtr(0) geçerli IErrorInfoIntPtr(-1) arabirimi yoksayıp özel durumu yalnızca hata kodundan oluşturmayı belirtebilirsinizIErrorInfo.

Döndürülenler

Exception

Dönüştürülen HRESULT'yi ve öğesinden errorInfoalınan bilgileri temsil eden veya null HRESULT değeri bir hata kodunu (örneğin, S_OK veya S_FALSE) temsil etmiyorsa bir nesne.

Açıklamalar

GetExceptionForHR yöntemini çağırmak Exception ve özel durumu yakalamak zorunda kalmadan bir HRESULT tabanlı almak ThrowExceptionForHR için yöntemini kullanın (böylece ilgili performans ek yükünü önler). errorInfo parametresi, hata hakkında metinsel açıklaması ve hatayı tanımlayan arabirimin genel benzersiz tanımlayıcısı (GUID) gibi ek bilgiler sağlar.

Dönüştürmede sağlamanız gereken özel hata bilgileriniz varsa bu yöntem aşırı yüklemesini kullanın.

her HRESULT'tan .NET Framework'teki karşılaştırılabilir özel durum sınıfına eşleme için bkz. H nasıl yapılır: HRESULTs ve Özel Durumları Eşleme.

Ayrıca bkz.

• ThrowExceptionForHR
• IErrorInfo Arabirimi

GetExceptionForHR(Int32, Guid, IntPtr)

Kaynak:

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

Parametreler

errorCode

Int32

iid

Guid

pUnk

IntPtr

nativeint

Döndürülenler

Exception