Marshal.GetExceptionForHR Método

Definição

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Converte um código de erro HRESULT para o objeto Exception correspondente.

Sobrecargas

GetExceptionForHR(Int32)	Converte o código de erro HRESULT especificado em um objeto Exception correspondente.
GetExceptionForHR(Int32, IntPtr)	Converte o código de erro HRESULT especificado em um objeto Exception correspondente, com informações de erro adicionais passadas em uma interface IErrorInfo para o objeto de exceção.

GetExceptionForHR(Int32)

Origem:

Marshal.cs

Converte o código de erro HRESULT especificado em um objeto Exception correspondente.

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

Parâmetros

errorCode

Int32

O HRESULT a ser convertido.

Retornos

Exception

Um objeto que representa o HRESULT convertido ou null se o valor de HRESULT não representar um código de erro (por exemplo, S_OK ou S_FALSE).

Comentários

Use o GetExceptionForHR método para obter um Exception com base em um HRESULT sem precisar chamar o ThrowExceptionForHR método e capturar a exceção.

A interface IErrorInfo atual é usada para construir a exceção.

Para o mapeamento de cada HRESULT para sua classe de exceção comparável no .NET Framework, consulte Como mapear HRESULTs e exceções.

Confira também

• ThrowExceptionForHR
• IErrorInfo Interface

GetExceptionForHR(Int32, IntPtr)

Origem:

Marshal.cs

Converte o código de erro HRESULT especificado em um objeto Exception correspondente, com informações de erro adicionais passadas em uma interface IErrorInfo para o objeto de exceção.

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

Parâmetros

errorCode

Int32

O HRESULT a ser convertido.

errorInfo

IntPtr

nativeint

Um ponteiro para a interface IErrorInfo que fornece mais informações sobre o erro. Você pode especificar IntPtr(0) para usar a interface IErrorInfo atual ou IntPtr(-1) para ignorar a interface IErrorInfo atual e construir a exceção com base apenas no código de erro.

Retornos

Exception

Um objeto que representa o HRESULT convertido e informações obtidas de errorInfo ou null se um valor HRESULT não representar um código de erro (por exemplo, S_OK ou S_FALSE).

Comentários

Use o GetExceptionForHR método para obter um Exception com base em um HRESULT sem precisar chamar o ThrowExceptionForHR método e capturar a exceção (evitando assim a sobrecarga de desempenho correspondente). O errorInfo parâmetro fornece informações adicionais sobre o erro, como sua descrição textual e o GUID (identificador global exclusivo) para a interface que definiu o erro.

Use essa sobrecarga de método se você tiver informações de erro personalizadas que você precisa fornecer na conversão.

Para o mapeamento de cada HRESULT para sua classe de exceção comparável no .NET Framework, consulte Como mapear HRESULTs e exceções.

Confira também

• ThrowExceptionForHR
• IErrorInfo Interface