Marshal.GetExceptionForHR Método

Definição

Converte um código de erro HRESULT para o objeto Exception correspondente.Converts an HRESULT error code to a corresponding Exception object.

Sobrecargas

GetExceptionForHR(Int32)

Converte o código de erro HRESULT especificado em um objeto Exception correspondente.Converts the specified HRESULT error code to a corresponding Exception object.

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.Converts the specified HRESULT error code to a corresponding Exception object, with additional error information passed in an IErrorInfo interface for the exception object.

GetExceptionForHR(Int32)

Converte o código de erro HRESULT especificado em um objeto Exception correspondente.Converts the specified HRESULT error code to a corresponding Exception object.

public:
 static Exception ^ GetExceptionForHR(int errorCode);
[System.Security.SecurityCritical]
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.The HRESULT to be converted.

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).An object that represents the converted HRESULT, or null if the HRESULT value doesn't represent an error code (for example, S_OK or S_FALSE).

Atributos

Comentários

Use o método GetExceptionForHR para obter uma Exception com base em um HRESULT sem precisar chamar o método ThrowExceptionForHR e capturar a exceção.Use the GetExceptionForHR method to get an Exception based on an HRESULT without having to call the ThrowExceptionForHR method and catch the exception.

A interface IErrorInfo atual é usada para construir a exceção.The current IErrorInfo interface is used to construct the exception.

Para o mapeamento de cada HRESULT para sua classe de exceção comparável no .NET Framework, consulte como mapear HRESULTs e exceções.For the mapping from each HRESULT to its comparable exception class in the .NET Framework, see How to: Map HRESULTs and Exceptions.

Segurança

SecurityCriticalAttribute
requer confiança total para o chamador imediato.requires full trust for the immediate caller. Este membro não pode ser usado pelo código transparente ou parcialmente confiável.This member cannot be used by partially trusted or transparent code.

Veja também

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.Converts the specified HRESULT error code to a corresponding Exception object, with additional error information passed in an IErrorInfo interface for the exception object.

public:
 static Exception ^ GetExceptionForHR(int errorCode, IntPtr errorInfo);
[System.Security.SecurityCritical]
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.The HRESULT to be converted.

errorInfo
IntPtr

Um ponteiro para a interface IErrorInfo que fornece mais informações sobre o erro.A pointer to the IErrorInfo interface that provides more information about the error. 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 apenas do código de erro.You can specify IntPtr(0) to use the current IErrorInfo interface, or IntPtr(-1) to ignore the current IErrorInfo interface and construct the exception just from the error code.

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).An object that represents the converted HRESULT and information obtained from errorInfo, or null if an HRESULT value doesn't represent an error code (for example, S_OK or S_FALSE).

Atributos

Comentários

Use o método GetExceptionForHR para obter uma Exception com base em um HRESULT sem precisar chamar o método ThrowExceptionForHR e capturar a exceção (evitando assim a sobrecarga de desempenho correspondente).Use the GetExceptionForHR method to get an Exception based on an HRESULT without having to call the ThrowExceptionForHR method and catch the exception (thus avoiding the corresponding performance overhead). O parâmetro errorInfo 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.The errorInfo parameter supplies additional information about the error, such as its textual description and the globally unique identifier (GUID) for the interface that defined the error.

Use essa sobrecarga de método se você tiver informações de erro personalizadas que você precisa fornecer na conversão.Use this method overload if you have custom error information that you have to supply in the conversion.

Para o mapeamento de cada HRESULT para sua classe de exceção comparável no .NET Framework, consulte como mapear HRESULTs e exceções.For the mapping from each HRESULT to its comparable exception class in the .NET Framework, see How to: Map HRESULTs and Exceptions.

Segurança

SecurityCriticalAttribute
requer confiança total para o chamador imediato.requires full trust for the immediate caller. Este membro não pode ser usado pelo código transparente ou parcialmente confiável.This member cannot be used by partially trusted or transparent code.

Veja também

Aplica-se a