Marshal.ThrowExceptionForHR Yöntem

Tanım

Ad Alanı:

System.Runtime.InteropServices

Bütünleştirilmiş Kod:

System.Runtime.InteropServices.dll

Belirli bir hata HRESULT değeriyle özel durum oluşturur.

Aşırı Yüklemeler

ThrowExceptionForHR(Int32)	Belirli bir hata HRESULT değeriyle özel durum oluşturur.
ThrowExceptionForHR(Int32, IntPtr)	Belirtilen IErrorInfo arabirimini temel alarak belirli bir hata HRESULT ile bir özel durum oluşturur.

ThrowExceptionForHR(Int32)

Kaynak:

Marshal.cs

Belirli bir hata HRESULT değeriyle özel durum oluşturur.

public:
 static void ThrowExceptionForHR(int errorCode);

public static void ThrowExceptionForHR (int errorCode);

static member ThrowExceptionForHR : int -> unit

Public Shared Sub ThrowExceptionForHR (errorCode As Integer)

Parametreler

errorCode

Int32

İstenen özel duruma karşılık gelen HRESULT.

Açıklamalar

Bu yöntem, belirtilen hata HRESULT için bir özel durum nesnesi oluşturur. HRESULT 0 veya pozitifse (başarı kodu), yöntem bir özel durum oluşturmadan veya oluşturmadan döndürür.

Yöntemin ThrowExceptionForHR(Int32) , ayarlanmışsa geçerli iş parçacığının IErrorInfo arabirimini temel alan bir özel durum döndürdüğünü unutmayın. Bu durumda parametresi errorCode yoksayılır.

Bazı hatalar HRESULTs tanımlı özel durumlarla eşlenirken diğerleri eşlenmez. HRESULT tanımlı bir özel durumla eşleniyorsa, ThrowExceptionForHR özel durumun bir örneğini oluşturur ve oluşturur. Aksi takdirde, bir örneği COMExceptionoluşturur, hata kodu alanını HRESULT ile başlatır ve bu özel durumu oluşturur. çağrıldığında ThrowExceptionForHR , yönetilmeyen GetErrorInfo işlevini kullanarak hatayla ilgili ek bilgileri almaya çalışır.

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

Bazen, ThrowExceptionForHR önceki bir COM çağrısından bir özel durum döndürebilir. Bu durumda, aşağıdaki geçici çözümü kullanabilir ve ikinci parametre olarak geçirebilirsiniz IntPtr(-1) (errorInfo):

public static void ThrowExceptionForHR(interrorCode,IntPtrerrorInfo)

Ayrıca bkz.

• COMException

ThrowExceptionForHR(Int32, IntPtr)

Kaynak:

Marshal.cs

Belirtilen IErrorInfo arabirimini temel alarak belirli bir hata HRESULT ile bir özel durum oluşturur.

public:
 static void ThrowExceptionForHR(int errorCode, IntPtr errorInfo);

public static void ThrowExceptionForHR (int errorCode, IntPtr errorInfo);

static member ThrowExceptionForHR : int * nativeint -> unit

Public Shared Sub ThrowExceptionForHR (errorCode As Integer, errorInfo As IntPtr)

Parametreler

errorCode

Int32

İstenen özel duruma karşılık gelen HRESULT.

errorInfo

IntPtr

nativeint

Hata hakkında daha fazla bilgi sağlayan IErrorInfo arabirimine yönelik bir işaretçi. Geçerli IErrorInfo arabirimini kullanmayı veya IntPtr(-1) geçerli IErrorInfo arabirimini yoksaymayı ve özel durumu yalnızca hata kodundan oluşturmayı belirtebilirsinizIntPtr(0).

Açıklamalar

Bu yöntem, belirtilen hata HRESULT için bir özel durum nesnesi oluşturur. HRESULT 0 veya pozitifse (başarı kodu), yöntem bir özel durum oluşturmadan veya oluşturmadan döndürür.

ThrowExceptionForHR yöntemi, IErrorInfo arabiriminin COM başvuru sayısını azaltarak parametresini serbest bırakırerrorInfo.

Yöntemin ThrowExceptionForHR , ayarlanmışsa geçerli iş parçacığının IErrorInfo arabirimini temel alan bir özel durum döndürdüğünü unutmayın. Bu durumda parametresi errorCode yoksayılır.

Bazı hatalar HRESULTs tanımlı özel durumlarla eşlenirken diğerleri eşlenmez. HRESULT tanımlı bir özel durumla eşleniyorsa, ThrowExceptionForHR özel durumun bir örneğini oluşturur ve oluşturur. Aksi takdirde, bir örneği System.Runtime.InteropServices.COMExceptionoluşturur, hata kodu alanını HRESULT ile başlatır ve bu özel durumu oluşturur. errorInfo parametresi hatayla ilgili ek bilgileri almak için kullanılır.

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

Ayrıca bkz.

• COMException