ErrorWrapper Classe

  • Référence

Définition

Espace de noms:
System.Runtime.InteropServices
Assembly:
System.Runtime.InteropServices.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Source:
ErrorWrapper.cs
Source:
ErrorWrapper.cs
Source:
ErrorWrapper.cs

Attention

ErrorWrapper and support for marshalling to the VARIANT type may be unavailable in future releases.

Encapsule des objets que le marshaleur doit marshaler comme VT_ERROR.

public ref class ErrorWrapper sealed
[System.Obsolete("ErrorWrapper and support for marshalling to the VARIANT type may be unavailable in future releases.")]
public sealed class ErrorWrapper
public sealed class ErrorWrapper
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public sealed class ErrorWrapper
[<System.Obsolete("ErrorWrapper and support for marshalling to the VARIANT type may be unavailable in future releases.")>]
type ErrorWrapper = class
type ErrorWrapper = class
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type ErrorWrapper = class
Public NotInheritable Class ErrorWrapper
Héritage
Object
ErrorWrapper
Attributs
ObsoleteAttribute ComVisibleAttribute SerializableAttribute

Exemples

L’exemple de code suivant illustre d’abord un objet unique Int32 marshalé à partir de COM en tant qu’objet Int32 . Il illustre ensuite un Int32 tableau marshalé à partir de COM en tant que UInt32 tableau.

// Scenario 1:  
// Pass a single value.  
Int32 x = 3;  
Object o = new ErrorWrapper(x);  
// Pass 'o' to COM.  
// On the return trip, 'o' has been unwrapped and is still an Int32 object.  
Int32 y = (Int32)o;  
Scenario 2:  
// Pass an array of values.  
Int32[] arr = new Int32[3];  
Object o = new ErrorWrapper(arr);  
// Pass 'o' to COM.  
// On the return trip, 'o' has been unwrapped and is now a UInt32[] array.  
UInt32[ ] arr2 = (UInt32[])o;

Remarques

Par défaut, Object les arguments de type sont marshalés en tant que VARIANT type, où le type d’objet détermine la VARTYPE valeur de .VARIANT

Le ErrorWrapper type doit être passé en tant que Object type à marshaler en tant que VARIANT de type VT_ERROR, sinon le ErrorWrapper type est marshalé en tant qu’entier.

Le tableau suivant illustre le marshaling dans un appel managé à une fonction native, à l’aide de l’appel de plateforme.

Paramètre de signature managée Valeur pArr Marshaled as
ErrorWrapper[] pArr ErrorWrapper[10] de ErrorWrapper(77) Int[10]
Object[] pArr ErrorWrapper[10] de ErrorWrapper(77) VARIANT[10] de VT_ERROR
Object[] pArr Objet[10] de ErrorWrapper(77) VARIANT[10] de VT_ERROR

Le tableau suivant illustre le marshaling des données dans un appel managé vers une fonction native, à l’aide de wrappers POUVANT appeler le runtime COM (RCW).

Paramètre de signature managée Valeur pArr Marshaled as
ErrorWrapper[] pArr ErrorWrapper[10] de ErrorWrapper(77) Int[10]
Object[] pArr ErrorWrapper[10] de ErrorWrapper(77) Exception SafeArrayTypeMismatch
Object[] pArr Objet[10] de ErrorWrapper(77) SAFEARRAY(VARIANT)

Notez que ErrorWrapper les objets ne sont pas marshalés en tant que type VT_ERROR après leur transmission à partir de COM. Une valeur unique est marshalée à partir de COM en tant que type VT_I4, tandis que les tableaux sont marshalés à partir de COM en tant que type VT_UI4.

Pour plus d’informations sur VT_ERROR, consultez la documentation existante pour VARENUM::VT_ERROR dans la bibliothèque MSDN.

Constructeurs

ErrorWrapper(Exception)
Obsolète.

Initialise une nouvelle instance de la classe ErrorWrapper avec le HRESULT correspondant à l'exception spécifiée.
ErrorWrapper(Int32)
Obsolète.

Initialise une nouvelle instance de la classe ErrorWrapper avec le HRESULT de l'erreur.
ErrorWrapper(Object)
Obsolète.

Initialise une nouvelle instance de la classe ErrorWrapper avec un objet contenant le HRESULT de l'erreur.

Propriétés

ErrorCode
Obsolète.

Obtient le code d'erreur du wrapper.

Méthodes

Equals(Object)
Obsolète.

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetHashCode()
Obsolète.

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()
Obsolète.

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()
Obsolète.

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ToString()
Obsolète.

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

S’applique à