Marshal.GetExceptionForHR Método

Definição

Namespace:
System.Runtime.InteropServices
Assemblies:
mscorlib.dll, System.Runtime.InteropServices.dll
Assembly:
mscorlib.dll
Assembly:
System.Runtime.InteropServices.dll
Assembly:
netstandard.dll

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

Sobrecargas

Nome Description
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 correspondente, com informações de erro adicionais passadas em uma interface IErrorInfo para o objeto de exceção.

GetExceptionForHR(Int32)

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);
[<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

Exception

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

Atributos
SecurityCriticalAttribute

Comentários

Use o GetExceptionForHR método para obter uma Exception 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 obter o mapeamento de cada HRESULT para sua classe de exceção comparável no .NET Framework, consulte How to: Map HRESULTs and Exceptions.

Confira também

Aplica-se a

GetExceptionForHR(Int32, IntPtr)

Converte o código de erro HRESULT especificado em um objeto 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);
[<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 IErrorInfo interface que fornece mais informações sobre o erro. Você pode especificar IntPtr(0) para usar a interface atual IErrorInfo ou IntPtr(-1) ignorar a interface atual IErrorInfo e construir a exceção apenas a partir do código de erro.

Retornos

Exception

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

Atributos
SecurityCriticalAttribute

Comentários

Use o GetExceptionForHR método para obter uma Exception 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 obter o mapeamento de cada HRESULT para sua classe de exceção comparável no .NET Framework, consulte How to: Map HRESULTs and Exceptions.

Confira também

Aplica-se a