Marshal.GetExceptionForHR Metode

Definisi

Ruang nama:

System.Runtime.InteropServices

Rakitan:

System.Runtime.InteropServices.dll

Mengonversi kode kesalahan HRESULT ke objek yang Exception sesuai.

Overload

GetExceptionForHR(Int32)	Mengonversi kode kesalahan HRESULT yang ditentukan ke objek yang Exception sesuai.
GetExceptionForHR(Int32, IntPtr)	Mengonversi kode kesalahan HRESULT yang ditentukan ke objek yang sesuai Exception , dengan informasi kesalahan tambahan yang diteruskan dalam antarmuka IErrorInfo untuk objek pengecualian.

GetExceptionForHR(Int32)

Sumber:

Marshal.cs

Mengonversi kode kesalahan HRESULT yang ditentukan ke objek yang Exception sesuai.

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

Parameter

errorCode

Int32

HRESULT yang akan dikonversi.

Mengembalikan

Exception

Objek yang mewakili HRESULT yang dikonversi, atau null jika nilai HRESULT tidak mewakili kode kesalahan (misalnya, S_OK atau S_FALSE).

Keterangan

GetExceptionForHR Gunakan metode untuk mendapatkan Exception berdasarkan HRESULT tanpa harus memanggil ThrowExceptionForHR metode dan menangkap pengecualian.

Antarmuka IErrorInfo saat ini digunakan untuk membangun pengecualian.

Untuk pemetaan dari setiap HRESULT ke kelas pengecualian yang sebanding di .NET Framework, lihat Cara: Memetakan HRESULT dan Pengecualian.

Lihat juga

• ThrowExceptionForHR
• Antarmuka IErrorInfo

GetExceptionForHR(Int32, IntPtr)

Sumber:

Marshal.cs

Mengonversi kode kesalahan HRESULT yang ditentukan ke objek yang sesuai Exception , dengan informasi kesalahan tambahan yang diteruskan dalam antarmuka IErrorInfo untuk objek pengecualian.

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

Parameter

errorCode

Int32

HRESULT yang akan dikonversi.

errorInfo

IntPtr

nativeint

Penunjuk ke IErrorInfo antarmuka yang menyediakan informasi lebih lanjut tentang kesalahan. Anda dapat menentukan IntPtr(0) untuk menggunakan antarmuka saat ini IErrorInfo , atau IntPtr(-1) untuk mengabaikan antarmuka saat ini IErrorInfo dan membuat pengecualian hanya dari kode kesalahan.

Mengembalikan

Exception

Objek yang mewakili HRESULT yang dikonversi dan informasi yang diperoleh dari errorInfo, atau null jika nilai HRESULT tidak mewakili kode kesalahan (misalnya, S_OK atau S_FALSE).

Keterangan

GetExceptionForHR Gunakan metode untuk mendapatkan Exception berdasarkan HRESULT tanpa harus memanggil ThrowExceptionForHR metode dan menangkap pengecualian (sehingga menghindari overhead performa yang sesuai). Parameter errorInfo memberikan informasi tambahan tentang kesalahan, seperti deskripsi tekstualnya dan pengidentifikasi unik global (GUID) untuk antarmuka yang menentukan kesalahan.

Gunakan metode ini kelebihan beban jika Anda memiliki informasi kesalahan kustom yang harus Anda berikan dalam konversi.

Untuk pemetaan dari setiap HRESULT ke kelas pengecualian yang sebanding di .NET Framework, lihat Cara: Memetakan HRESULT dan Pengecualian.

Lihat juga

• ThrowExceptionForHR
• Antarmuka IErrorInfo