ErrorWrapper Clase

Definición

Espacio de nombres:

System.Runtime.InteropServices

Ensamblado:

System.Runtime.InteropServices.dll

Ensamblado:

mscorlib.dll

Ensamblado:

netstandard.dll

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

Object

ErrorWrapper

Atributos

ObsoleteAttribute ComVisibleAttribute SerializableAttribute

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)