Marshal.GetExceptionForHR Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Converte um código de erro HRESULT num objeto correspondente Exception .
Sobrecargas
| Name | Description |
|---|---|
| GetExceptionForHR(Int32) |
Converte o código de erro HRESULT especificado para um objeto correspondente Exception . |
| GetExceptionForHR(Int32, IntPtr) |
Converte o código de erro HRESULT especificado para um objeto correspondente Exception , com informação adicional de erro passada numa interface IErrorInfo para o objeto exceção. |
GetExceptionForHR(Int32)
Converte o código de erro HRESULT especificado para um objeto correspondente Exception .
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 -> Exceptionstatic member GetExceptionForHR : int -> ExceptionPublic Shared Function GetExceptionForHR (errorCode As Integer) As ExceptionParâmetros
- errorCode
- Int32
O HRESULT a ser convertido.
Devoluções
Um objeto que representa o HRESULT convertido, ou null se o valor do HRESULT não representa um código de erro (por exemplo, S_OK ou S_FALSE).
- Atributos
Observações
Use o GetExceptionForHR método para obter um Exception baseado num HRESULT sem ter de chamar o ThrowExceptionForHR método e apanhar a exceção.
A interface atual IErrorInfo é usada para construir a exceção.
Para o mapeamento de cada HRESULT para a sua classe de exceção comparável no .NET Framework, veja How to: Map HRESULTs and Exceptions.
Ver também
Aplica-se a
GetExceptionForHR(Int32, IntPtr)
Converte o código de erro HRESULT especificado para um objeto correspondente Exception , com informação adicional de erro passada numa interface IErrorInfo para o objeto 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 -> Exceptionstatic member GetExceptionForHR : int * nativeint -> ExceptionPublic Shared Function GetExceptionForHR (errorCode As Integer, errorInfo As IntPtr) As ExceptionParâ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. Podes 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.
Devoluções
Um objeto que representa o HRESULT convertido e a informação obtida de errorInfo, ou null se um valor HRESULT não representar um código de erro (por exemplo, S_OK ou S_FALSE).
- Atributos
Observações
Use o GetExceptionForHR método para obter um Exception baseado num HRESULT sem ter de chamar o ThrowExceptionForHR método e apanhar a exceção (evitando assim a sobrecarga de desempenho correspondente). O errorInfo parâmetro fornece informações adicionais sobre o erro, como a sua descrição textual e o identificador globalmente único (GUID) da interface que definiu o erro.
Use este método de sobrecarga se tiver informações de erro personalizadas para fornecer na conversão.
Para o mapeamento de cada HRESULT para a sua classe de exceção comparável no .NET Framework, veja How to: Map HRESULTs and Exceptions.