ErrorWrapper ErrorWrapper ErrorWrapper ErrorWrapper Class

Definición

Advertencia

Esta API está ya obsoleta.

Ajusta los objetos que el contador de referencias debe calcular referencias como un VT_ERROR.Wraps objects the marshaler should marshal as a VT_ERROR.

public ref class ErrorWrapper sealed
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
[System.Obsolete("ErrorWrapper and support for marshalling to the VARIANT type may be unavailable in future releases.")]
public sealed class ErrorWrapper
type ErrorWrapper = class
Public NotInheritable Class ErrorWrapper
Herencia
ErrorWrapperErrorWrapperErrorWrapperErrorWrapper
Atributos

Ejemplos

El ejemplo de código siguiente muestra primero solos Int32 objeto vuelve a calcular desde COM como una Int32 objeto.The following code example first demonstrates a lone Int32 object marshaled back from COM as an Int32 object. A continuación se muestra un Int32 matriz vuelve a calcular desde COM como una UInt32 matriz.It then demonstrates an Int32 array marshaled back from COM as a UInt32 array.

// 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 argumentos de tipo se serializan como un VARIANT tipo, donde el tipo de objeto determina el VARTYPE valor de la VARIANT.By default, Object type arguments are marshaled as a VARIANT type, where the object type determines the VARTYPE value of the VARIANT.

El ErrorWrapper tipo debe pasarse como un Object tipo que se van a calcular como un VARIANT de tipo VT_ERRORen caso contrario, el ErrorWrapper tipo se serializa como un entero.The ErrorWrapper type must to be passed as an Object type to be marshaled as a VARIANT of type VT_ERROR, otherwise the ErrorWrapper type is marshaled as an integer.

En la tabla siguiente se muestra el cálculo de referencias en una llamada a una función nativa, administrada usar invocación de plataforma.The following table illustrates marshaling in a managed call to a native function, using platform invoke.

Parámetro de la firma administradaManaged signature parameter valor pArrpArr value Serializa comoMarshaled as
ErrorWrapper[] pArrErrorWrapper[] pArr ErrorWrapper [10] de ErrorWrapper (77)ErrorWrapper[10] of ErrorWrapper(77) Int[10]
Object[] pArrObject[] pArr ErrorWrapper [10] de ErrorWrapper (77)ErrorWrapper[10] of ErrorWrapper(77) VARIANT[10] de VT_ERRORVARIANT[10] of VT_ERROR
Object[] pArrObject[] pArr Objeto [10] de ErrorWrapper (77)Object[10] of ErrorWrapper(77) VARIANT[10] de VT_ERRORVARIANT[10] of VT_ERROR

En la tabla siguiente se muestra la serialización de datos en una llamada administrada para una función nativa, usando contenedores RCW de COM en tiempo de ejecución (RCW).The following table illustrates marshaling data in a managed call to a native function, using COM runtime callable wrappers (RCW).

Parámetro de la firma administradaManaged signature parameter valor pArrpArr value Serializa comoMarshaled as
ErrorWrapper[] pArrErrorWrapper[] pArr ErrorWrapper [10] de ErrorWrapper (77)ErrorWrapper[10] of ErrorWrapper(77) Int[10]
Object[] pArrObject[] pArr ErrorWrapper [10] de ErrorWrapper (77)ErrorWrapper[10] of ErrorWrapper(77) SafeArrayTypeMismatch ExcepciónSafeArrayTypeMismatch exception
Object[] pArrObject[] pArr Objeto [10] de ErrorWrapper (77)Object[10] of ErrorWrapper(77) SAFEARRAY(VARIANT)

Tenga en cuenta que ErrorWrapper objetos no se serializan como tipo VT_ERROR después de que se pasan desde COM.Note that ErrorWrapper objects are not marshaled as type VT_ERROR after they are passed back from COM. Se calculan las referencias de un único valor desde COM como tipo VT_I4, mientras que las matrices se vuelve a calcular desde COM como tipo VT_UI4.A single value is marshaled back from COM as type VT_I4, while arrays are marshaled back from COM as type VT_UI4.

Para obtener más información sobre VT_ERROR, consulte la documentación existente para VARENUM::VT_ERROR en MSDN library.For more information on VT_ERROR, please see the existing documentation for VARENUM::VT_ERROR in the MSDN library.

Constructores

ErrorWrapper(Exception) ErrorWrapper(Exception) ErrorWrapper(Exception) ErrorWrapper(Exception)

Inicializa una nueva instancia de la ErrorWrapper clase con el HRESULT que corresponda a la excepción suministrada.Initializes a new instance of the ErrorWrapper class with the HRESULT that corresponds to the exception supplied.

ErrorWrapper(Int32) ErrorWrapper(Int32) ErrorWrapper(Int32) ErrorWrapper(Int32)

Inicializa una nueva instancia de la ErrorWrapper clase con el valor HRESULT del error.Initializes a new instance of the ErrorWrapper class with the HRESULT of the error.

ErrorWrapper(Object) ErrorWrapper(Object) ErrorWrapper(Object) ErrorWrapper(Object)

Inicializa una nueva instancia de la ErrorWrapper clase con un objeto que contiene el HRESULT del error.Initializes a new instance of the ErrorWrapper class with an object containing the HRESULT of the error.

Propiedades

ErrorCode ErrorCode ErrorCode ErrorCode

Obtiene el código de error del contenedor.Gets the error code of the wrapper.

Métodos

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Se aplica a