Marshal.GetExceptionForHR Yöntem

Tanım

Ad Alanı:

System.Runtime.InteropServices

Bütünleştirilmiş Kod:

System.Runtime.InteropServices.dll

HRESULT hata kodunu karşılık gelen Exception bir nesneye dönüştürür.

Aşırı Yüklemeler

GetExceptionForHR(Int32)	Belirtilen HRESULT hata kodunu karşılık gelen Exception bir nesneye dönüştürür.
GetExceptionForHR(Int32, IntPtr)	Belirtilen HRESULT hata kodunu karşılık gelen Exception bir nesneye dönüştürür ve özel durum nesnesi için IErrorInfo arabiriminde ek hata bilgileri geçirilir.

GetExceptionForHR(Int32)

Kaynak:

Marshal.cs

Belirtilen HRESULT hata kodunu karşılık gelen Exception bir nesneye 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_FALSE) temsil etmiyorsa bir S_OK nesne.

Açıklamalar

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

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

Her HRESULT öğesinin .NET Framework karşılaştırılabilir özel durum sınıfına eşlemesi için bkz. 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 karşılık gelen Exception bir nesneye 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(-1) geçerli IErrorInfoIErrorInfo arabirimi yoksaymayı ve özel durumu yalnızca hata kodundan oluşturmayı belirtebilirsinizIntPtr(0).

Döndürülenler

Exception

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

Açıklamalar

GetExceptionForHR yöntemini çağırmak ThrowExceptionForHR ve özel durumu yakalamak zorunda kalmadan bir HRESULT tabanlı almak Exception için yöntemini kullanın (böylece ilgili performans ek yükünü önleyin). errorInfo parametresi, hata hakkında metinsel açıklaması ve hatayı tanımlayan arabirim için genel olarak benzersiz tanımlayıcı (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 öğesinin .NET Framework karşılaştırılabilir özel durum sınıfına eşlemesi için bkz. Nasıl yapılır: HRESULTs ve Özel Durumları Eşleme.

Ayrıca bkz.

• ThrowExceptionForHR
• IErrorInfo Arabirimi