ErrorWrapper Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Precaución
ErrorWrapper and support for marshalling to the VARIANT type may be unavailable in future releases.
Encapsula los objetos cuyas referencias se van a calcular como 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
- Herencia
-
ErrorWrapper
- Atributos
Ejemplos
En el ejemplo de código siguiente se muestra primero un objeto solitario Int32 serializado desde COM como un Int32 objeto . A continuación, muestra una Int32 matriz serializado de COM como una UInt32 matriz.
// 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;
Comentarios
De forma predeterminada, Object los argumentos de tipo se serializarán como un VARIANT tipo, donde el tipo de objeto determina el VARTYPE valor de VARIANT.
El ErrorWrapper tipo debe pasarse como un Object tipo que se va a serializar como de VARIANT tipo VT_ERROR; de lo contrario, el ErrorWrapper tipo se serializa como un entero.
En la tabla siguiente se muestran las referencias de una llamada administrada a una función nativa mediante la invocación de plataforma.
| Parámetro de firma administrada | Valor de pArr | Serializado como |
|---|---|---|
| ErrorWrapper[] pArr | ErrorWrapper[10] de ErrorWrapper(77) | Int[10] |
| Object[] pArr | ErrorWrapper[10] de ErrorWrapper(77) |
VARIANT[10] de VT_ERROR |
| Object[] pArr | Objeto[10] de ErrorWrapper(77) |
VARIANT[10] de VT_ERROR |
En la tabla siguiente se muestran las referencias de datos en una llamada administrada a una función nativa mediante contenedores invocables (RCW) en tiempo de ejecución COM.
| Parámetro de firma administrada | Valor de pArr | Serializado como |
|---|---|---|
| ErrorWrapper[] pArr | ErrorWrapper[10] de ErrorWrapper(77) | Int[10] |
| Object[] pArr | ErrorWrapper[10] de ErrorWrapper(77) | Excepción de SafeArrayTypeMismatch |
| Object[] pArr | Objeto[10] de ErrorWrapper(77) | SAFEARRAY(VARIANT) |
Tenga en cuenta que ErrorWrapper los objetos no se serializarán como tipo VT_ERROR después de que se devuelvan desde COM. Un único valor se serializa desde COM como tipo VT_I4, mientras que las matrices se serializan de nuevo desde COM como tipo VT_UI4.
Para obtener más información sobre VT_ERROR, consulte la documentación existente de VARENUM::VT_ERROR en MSDN Library.
Constructores
| ErrorWrapper(Exception) |
Obsoletos.
Inicializa una nueva instancia de la clase ErrorWrapper con el HRESULT que corresponda a la excepción suministrada. |
| ErrorWrapper(Int32) |
Obsoletos.
Inicializa una nueva instancia de la clase ErrorWrapper con el HRESULT del error. |
| ErrorWrapper(Object) |
Obsoletos.
Inicializa una nueva instancia de la clase ErrorWrapper con un objeto que contiene el HRESULT del error. |
Propiedades
| ErrorCode |
Obsoletos.
Obtiene el código de error del contenedor. |
Métodos
| Equals(Object) |
Obsoletos.
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
| GetHashCode() |
Obsoletos.
Sirve como la función hash predeterminada. (Heredado de Object) |
| GetType() |
Obsoletos.
Obtiene el Type de la instancia actual. (Heredado de Object) |
| MemberwiseClone() |
Obsoletos.
Crea una copia superficial del Object actual. (Heredado de Object) |
| ToString() |
Obsoletos.
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |