Marshal.GetExceptionForHR Metodo

Definizione

Spazio dei nomi:: System.Runtime.InteropServices

Assembly:: mscorlib.dll, System.Runtime.InteropServices.dll

Assembly:: netstandard.dll, System.Runtime.InteropServices.dll

Assembly:: System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

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 di errore HRESULT in un oggetto corrispondente Exception .

Overload

Nome	Descrizione
GetExceptionForHR(Int32)	Converte il codice di errore HRESULT specificato in un oggetto corrispondente Exception .
GetExceptionForHR(Int32, IntPtr)	Converte il codice di errore HRESULT specificato in un oggetto corrispondente Exception , con informazioni aggiuntive sull'errore passate in un'interfaccia IErrorInfo per l'oggetto eccezione.
GetExceptionForHR(Int32, Guid, IntPtr)

GetExceptionForHR(Int32)

Origine:: Marshal.cs

Origine:: Marshal.cs

Origine:: Marshal.cs

Origine:: Marshal.cs

Origine:: Marshal.cs

Converte il codice di errore HRESULT specificato in un oggetto corrispondente Exception .

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 -> Exception

static member GetExceptionForHR : int -> Exception

Public Shared Function GetExceptionForHR (errorCode As Integer) As Exception

Parametri

errorCode: Int32

HRESULT da convertire.

Valori restituiti

Exception

Oggetto che rappresenta l'HRESULT convertito o null se il valore HRESULT non rappresenta un codice di errore , ad esempio S_OK o S_FALSE.

Attributi: SecurityCriticalAttribute

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 Come: Eseguire il mapping di HRESULT ed eccezioni.

Vedi anche

Si applica a

GetExceptionForHR(Int32, IntPtr)

Origine:: Marshal.cs

Origine:: Marshal.cs

Origine:: Marshal.cs

Origine:: Marshal.cs

Origine:: Marshal.cs

Converte il codice di errore HRESULT specificato in un oggetto corrispondente Exception , con informazioni aggiuntive 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 -> Exception

static member GetExceptionForHR : int * nativeint -> Exception

Public Shared Function GetExceptionForHR (errorCode As Integer, errorInfo As IntPtr) As Exception

Parametri

errorCode: Int32

HRESULT da convertire.

errorInfo: IntPtr
nativeint

Puntatore all'interfaccia IErrorInfo che fornisce altre informazioni sull'errore. È possibile specificare IntPtr(0) di usare l'interfaccia corrente IErrorInfo o IntPtr(-1) di ignorare l'interfaccia corrente IErrorInfo e costruire l'eccezione solo dal codice di errore.

Valori restituiti

Exception

Oggetto che rappresenta l'HRESULT convertito e le informazioni ottenute da errorInfoo null se un valore HRESULT non rappresenta un codice di errore (ad esempio, S_OK o S_FALSE).

Attributi: SecurityCriticalAttribute

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 Come: Eseguire il mapping di HRESULT ed eccezioni.

Vedi anche

Si applica a

GetExceptionForHR(Int32, Guid, IntPtr)

Origine:: Marshal.cs

Origine:: Marshal.cs

public:
 static Exception ^ GetExceptionForHR(int errorCode, Guid % iid, IntPtr pUnk);

public static Exception? GetExceptionForHR(int errorCode, in Guid iid, IntPtr pUnk);

static member GetExceptionForHR : int * Guid * nativeint -> Exception

Public Shared Function GetExceptionForHR (errorCode As Integer, ByRef iid As Guid, pUnk As IntPtr) As Exception

Parametri

errorCode: Int32

iid: Guid

pUnk: IntPtr
nativeint

Valori restituiti

Exception

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?