Marshal.GetExceptionForHR Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Convierte un código de error HRESULT en un objeto de Exception correspondiente.
Sobrecargas
| GetExceptionForHR(Int32) |
Convierte el código de error HRESULT especificado en un objeto de Exception correspondiente. |
| GetExceptionForHR(Int32, IntPtr) |
Convierte el código de error HRESULT especificado en un objeto de Exception correspondiente, con información de error adicional pasada en una interfaz de IErrorInfo para el objeto de excepción. |
GetExceptionForHR(Int32)
- Source:
- Marshal.cs
- Source:
- Marshal.cs
- Source:
- Marshal.cs
Convierte el código de error HRESULT especificado en un objeto de Exception correspondiente.
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 -> Exceptionstatic member GetExceptionForHR : int -> ExceptionPublic Shared Function GetExceptionForHR (errorCode As Integer) As ExceptionParámetros
- errorCode
- Int32
HRESULT que se va a convertir.
Devoluciones
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).
- Atributos
Comentarios
Use el método GetExceptionForHR para obtener un Exception basado en un HRESULT sin tener que llamar al método ThrowExceptionForHR y detectar la excepción.
La interfaz IErrorInfo actual se usa para construir la excepción.
Para obtener la asignación de cada HRESULT a su clase de excepción comparable en .NET Framework, consulte How to: Map HRESULTs and Exceptions.
Consulte también
- ThrowExceptionForHR
- de interfaz IErrorInfo de
Se aplica a
GetExceptionForHR(Int32, IntPtr)
- Source:
- Marshal.cs
- Source:
- Marshal.cs
- Source:
- Marshal.cs
Convierte el código de error HRESULT especificado en un objeto de Exception correspondiente, con información de error adicional pasada en una interfaz de IErrorInfo para el objeto de excepción.
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 -> Exceptionstatic member GetExceptionForHR : int * nativeint -> ExceptionPublic Shared Function GetExceptionForHR (errorCode As Integer, errorInfo As IntPtr) As ExceptionPará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) usar la interfaz de IErrorInfo actual o IntPtr(-1) para omitir la interfaz de IErrorInfo actual y construir la excepción solo a partir del código de error.
Devoluciones
Objeto que representa el HRESULT convertido y la información obtenida de errorInfo, o null si un valor HRESULT no representa un código de error (por ejemplo, S_OK o S_FALSE).
- Atributos
Comentarios
Use el método GetExceptionForHR para obtener un Exception basado en un HRESULT sin tener que llamar al método ThrowExceptionForHR y detectar la excepción (evitando así la sobrecarga de rendimiento correspondiente). El parámetro errorInfo 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 obtener la asignación de cada HRESULT a su clase de excepción comparable en .NET Framework, consulte How to: Map HRESULTs and Exceptions.
Consulte también
- ThrowExceptionForHR
- de interfaz IErrorInfo de
