Marshal.GetExceptionForHR Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Converte un codice errore HRESULT in un oggetto Exception corrispondente.
Overload
| GetExceptionForHR(Int32) |
Converte il codice errore HRESULT specificato in un oggetto Exception corrispondente. |
| GetExceptionForHR(Int32, IntPtr) |
Converte il codice di errore HRESULT specificato in un oggetto Exception corrispondente, con ulteriori informazioni sull'errore passate in un'interfaccia IErrorInfo per l'oggetto eccezione. |
GetExceptionForHR(Int32)
- Origine:
- Marshal.cs
- Origine:
- Marshal.cs
- Origine:
- Marshal.cs
Converte il codice errore HRESULT specificato in un oggetto Exception corrispondente.
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 ExceptionParametri
- errorCode
- Int32
Codice errore HRESULT da convertire.
Restituisce
Oggetto che rappresenta il valore HRESULT convertito oppure null se il valore HRESULT non rappresenta un codice errore (ad esempio, S_OK o S_FALSE).
- Attributi
Commenti
Usare il GetExceptionForHR metodo per ottenere un Exception oggetto basato su hresult senza dover chiamare il ThrowExceptionForHR metodo e intercettare l'eccezione.
L'interfaccia IErrorInfo corrente viene usata per costruire l'eccezione.
Per il mapping da ogni HRESULT alla relativa classe di eccezione paragonabile in .NET Framework, vedere Procedura: Eseguire il mapping di HRESULT ed eccezioni.
Vedi anche
Si applica a
GetExceptionForHR(Int32, IntPtr)
- Origine:
- Marshal.cs
- Origine:
- Marshal.cs
- Origine:
- Marshal.cs
Converte il codice di errore HRESULT specificato in un oggetto Exception corrispondente, con ulteriori informazioni sull'errore passate in un'interfaccia IErrorInfo per l'oggetto eccezione.
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 ExceptionParametri
- errorCode
- Int32
Codice errore HRESULT da convertire.
- errorInfo
-
IntPtr
nativeint
Puntatore all'interfaccia IErrorInfo che fornisce informazioni aggiuntive sull'errore. È possibile specificare IntPtr(0) per usare l'interfaccia IErrorInfo corrente oppure IntPtr(-1) per ignorare l'interfaccia IErrorInfo corrente e costruire l'eccezione unicamente dal codice errore.
Restituisce
Oggetto che rappresenta il valore HRESULT convertito e le informazioni ottenute da errorInfo oppure null se un valore HRESULT non rappresenta un codice errore (ad esempio, S_OK o S_FALSE).
- Attributi
Commenti
Usare il GetExceptionForHR metodo per ottenere un Exception oggetto basato su HRESULT senza dover chiamare il ThrowExceptionForHR metodo e intercettare l'eccezione , evitando così il sovraccarico delle prestazioni corrispondente. Il errorInfo parametro fornisce informazioni aggiuntive sull'errore, ad esempio la relativa descrizione testuale e l'identificatore univoco globale (GUID) per l'interfaccia che ha definito l'errore.
Utilizzare questo overload del metodo se sono presenti informazioni di errore personalizzate che è necessario fornire nella conversione.
Per il mapping da ogni HRESULT alla relativa classe di eccezione paragonabile in .NET Framework, vedere Procedura: Eseguire il mapping di HRESULT ed eccezioni.
