Compartilhar via


Marshal.GetExceptionForHR Método

Definição

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
Origem:
Marshal.cs
Origem:
Marshal.cs

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

public:
 static Exception ^ GetExceptionForHR(int errorCode);
[System.Security.SecurityCritical]
public static Exception GetExceptionForHR (int errorCode);
public static Exception? GetExceptionForHR (int errorCode);
public static Exception GetExceptionForHR (int errorCode);
[<System.Security.SecurityCritical>]
static member GetExceptionForHR : int -> Exception
static member GetExceptionForHR : int -> Exception
Public Shared Function GetExceptionForHR (errorCode As Integer) As Exception

Parâmetros

errorCode
Int32

O HRESULT a ser convertido.

Retornos

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).

Atributos

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

Aplica-se a

GetExceptionForHR(Int32, IntPtr)

Origem:
Marshal.cs
Origem:
Marshal.cs
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);
[System.Security.SecurityCritical]
public static Exception GetExceptionForHR (int errorCode, IntPtr errorInfo);
public static Exception? GetExceptionForHR (int errorCode, IntPtr errorInfo);
public static Exception GetExceptionForHR (int errorCode, IntPtr errorInfo);
[<System.Security.SecurityCritical>]
static member GetExceptionForHR : int * nativeint -> Exception
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

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).

Atributos

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

Aplica-se a