Marshal.GetExceptionForHR Método

Definición

Espacio de nombres:

System.Runtime.InteropServices

Ensamblado:

System.Runtime.InteropServices.dll

Convierte un código de error HRESULT en un objeto Exception correspondiente.

Sobrecargas

GetExceptionForHR(Int32)	Convierte el código de error HRESULT especificado en un objeto Exception correspondiente.
GetExceptionForHR(Int32, IntPtr)	Convierte el código de error HRESULT especificado en un objeto Exception correspondiente, con información de error adicional pasada en una interfaz IErrorInfo para el objeto de excepción.

GetExceptionForHR(Int32)

Source:

Marshal.cs

Convierte el código de error HRESULT especificado en un objeto Exception correspondiente.

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

HRESULT que se va a convertir.

Devoluciones

Exception

Objeto que representa el valor HRESULT convertido, o null si el valor HRESULT no representa un código de error (por ejemplo, S_OK o S_FALSE).

Comentarios

Use el GetExceptionForHR método para obtener un Exception basado en un HRESULT sin tener que llamar al ThrowExceptionForHR método y detectar la excepción.

La interfaz IErrorInfo actual se usa para construir la excepción.

Para la asignación de cada HRESULT a su clase de excepción comparable en .NET Framework, vea How to: Map HRESULTs and Exceptions.

Consulte también

• ThrowExceptionForHR
• Interfaz IErrorInfo

GetExceptionForHR(Int32, IntPtr)

Source:

Marshal.cs

Convierte el código de error HRESULT especificado en un objeto Exception correspondiente, con información de error adicional pasada en una interfaz IErrorInfo para el objeto de excepción.

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

HRESULT que se va a convertir.

errorInfo

IntPtr

nativeint

Puntero a la interfaz IErrorInfo que proporciona más información sobre el error. Puede especificar IntPtr(0) para utilizar la interfaz IErrorInfo actual o IntPtr(-1) para omitir la interfaz IErrorInfo actual y construir la excepción del código de error únicamente.

Devoluciones

Exception

Objeto que representa el valor HRESULT convertido e información obtenida de errorInfo, o null si el valor HRESULT no representa un código de error (por ejemplo, S_OK o S_FALSE).

Comentarios

Use el GetExceptionForHR método para obtener un Exception basado en un HRESULT sin tener que llamar al ThrowExceptionForHR método y detectar la excepción (lo que evita la sobrecarga de rendimiento correspondiente). El errorInfo parámetro proporciona información adicional sobre el error, como su descripción textual y el identificador único global (GUID) para la interfaz que definió el error.

Use esta sobrecarga de método si tiene información de error personalizada que debe proporcionar en la conversión.

Para la asignación de cada HRESULT a su clase de excepción comparable en .NET Framework, vea How to: Map HRESULTs and Exceptions.

Consulte también

• ThrowExceptionForHR
• Interfaz IErrorInfo