ErrorWrapper Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
-
ErrorWrapper
- Attributs
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 du 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 d’un appel de plateforme.
Paramètre de signature managée | Valeur pArr | Marshalé en tant que |
---|---|---|
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é à une fonction native, à l’aide de wrappers RCW (RUNTIME COM).
Paramètre de signature managée | Valeur pArr | Marshalé en tant que |
---|---|---|
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
une fois qu’ils sont repassés à 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) |