Marshal.GetExceptionForHR Metoda

Definicja

Przestrzeń nazw:

System.Runtime.InteropServices

Zestaw:

System.Runtime.InteropServices.dll

Konwertuje kod błędu HRESULT na odpowiedni Exception obiekt.

Przeciążenia

GetExceptionForHR(Int32)	Konwertuje określony kod błędu HRESULT na odpowiedni Exception obiekt.
GetExceptionForHR(Int32, IntPtr)	Konwertuje określony kod błędu HRESULT na odpowiedni Exception obiekt z dodatkowymi informacjami o błędzie przekazanymi w interfejsie IErrorInfo dla obiektu wyjątku.

GetExceptionForHR(Int32)

Źródło:

Marshal.cs

Konwertuje określony kod błędu HRESULT na odpowiedni Exception obiekt.

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

HrESULT, który ma zostać przekonwertowany.

Zwraca

Exception

Obiekt reprezentujący przekonwertowaną wartość HRESULT lub null jeśli wartość HRESULT nie reprezentuje kodu błędu (na przykład S_OK lub S_FALSE).

Uwagi

GetExceptionForHR Użyj metody , aby uzyskać na Exception podstawie hrESULT bez konieczności wywoływania ThrowExceptionForHR metody i przechwytywania wyjątku.

Bieżący interfejs IErrorInfo służy do konstruowania wyjątku.

Aby uzyskać mapowanie z każdej klasy HRESULT na porównywalną klasę wyjątków w .NET Framework, zobacz Instrukcje: mapowanie hrESULTów i wyjątków.

Zobacz też

• ThrowExceptionForHR
• IErrorInfo, interfejs

GetExceptionForHR(Int32, IntPtr)

Źródło:

Marshal.cs

Konwertuje określony kod błędu HRESULT na odpowiedni Exception obiekt z dodatkowymi informacjami o błędzie przekazanymi w interfejsie IErrorInfo dla obiektu wyjątku.

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

HrESULT, który ma zostać przekonwertowany.

errorInfo

IntPtr

nativeint

Wskaźnik do interfejsu IErrorInfo , który zawiera więcej informacji o błędzie. Możesz określić IntPtr(0) , aby użyć bieżącego IErrorInfo interfejsu lub IntPtr(-1) zignorować bieżący IErrorInfo interfejs i skonstruować wyjątek tylko z kodu błędu.

Zwraca

Exception

Obiekt reprezentujący przekonwertowany element HRESULT i informacje uzyskane z errorInfoobiektu lub null jeśli wartość HRESULT nie reprezentuje kodu błędu (na przykład S_OK lub S_FALSE).

Uwagi

GetExceptionForHR Użyj metody , aby uzyskać na Exception podstawie hrESULT bez konieczności wywoływania metody i przechwytywania wyjątku ThrowExceptionForHR (w ten sposób unikając odpowiedniego nakładu pracy nad wydajnością). Parametr errorInfo dostarcza dodatkowe informacje o błędzie, takie jak opis tekstowy i globalnie unikatowy identyfikator (GUID) dla interfejsu, który zdefiniował błąd.

Użyj tego przeciążenia metody, jeśli masz niestandardowe informacje o błędzie, które należy podać w konwersji.

Aby uzyskać mapowanie z każdej klasy HRESULT na porównywalną klasę wyjątków w .NET Framework, zobacz Instrukcje: mapowanie hrESULTów i wyjątków.

Zobacz też

• ThrowExceptionForHR
• IErrorInfo, interfejs