ErrorWrapper Classe

Définition

Espace de noms:

System.Runtime.InteropServices

Assembly:

mscorlib.dll

Encapsule les objets que le marshaleur doit marshaler en tant que VT_ERROR.

public ref class ErrorWrapper sealed

[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public sealed class ErrorWrapper

[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type ErrorWrapper = class

Public NotInheritable Class ErrorWrapper

Héritage

Object

ErrorWrapper

Attributs

ComVisibleAttribute SerializableAttribute

Exemples

L’exemple de code suivant illustre d’abord un objet seul 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 du VARIANT.

Le ErrorWrapper type doit être passé en tant que Object type à marshaler en tant que VARIANT type 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 d’un 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	Object[10] de ErrorWrapper(77)	VARIANT[10] de VT_ERROR

Le tableau suivant illustre le marshaling des données dans un appel managé à une fonction native, à l’aide de wrappers pouvant être appelé par 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	Object[10] de ErrorWrapper(77)	SAFEARRAY(VARIANT)

Notez que ErrorWrapper les objets ne sont pas marshalés comme type VT_ERROR après leur retour à 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 de VARENUM::VT_ERROR la bibliothèque MSDN.

Constructeurs

Nom	Description
ErrorWrapper(Exception)	Initialise une nouvelle instance de la ErrorWrapper classe avec hrESULT qui correspond à l’exception fournie.
ErrorWrapper(Int32)	Initialise une nouvelle instance de la ErrorWrapper classe avec HRESULT de l’erreur.
ErrorWrapper(Object)	Initialise une nouvelle instance de la ErrorWrapper classe avec un objet contenant le HRESULT de l’erreur.

Propriétés

Nom	Description
ErrorCode	Obtient le code d’erreur du wrapper.

Méthodes

Nom	Description
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)