ErrorWrapper ErrorWrapper ErrorWrapper ErrorWrapper Class

Definition

Warnung

Diese API ist jetzt veraltet.

Erstellt einen Wrapper für Objekte, die der Marshaller als VT_ERROR marshallen soll.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
Vererbung
ErrorWrapperErrorWrapperErrorWrapperErrorWrapper
Attribute

Beispiele

Im folgenden Codebeispiel wird zuerst ein einzelnes Int32 Objekt veranschaulicht, das von com Int32 als-Objekt zurück gemarshallt wird.The following code example first demonstrates a lone Int32 object marshaled back from COM as an Int32 object. Anschließend wird ein Int32 Array veranschaulicht, das von com UInt32 als-Array gemarshallt wird.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;  

Hinweise

Standardmäßig Object werden Typargumente VARIANT als-Typ gemarshallt, wobei der-Objekttyp VARIANTden VARTYPE Wert von bestimmt.By default, Object type arguments are marshaled as a VARIANT type, where the object type determines the VARTYPE value of the VARIANT.

Der ErrorWrapper Typ muss Object als Typ, der als VARIANT -Typ gemarshallt wird, als vom VT_ERRORTyp gemarshallt werden. andernfalls wird der ErrorWrapper Typ als ganze Zahl gemarshallt.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.

In der folgenden Tabelle wird das Marshalling in einem verwalteten Aufruf einer nativen Funktion mithilfe von Platt Form aufrufen veranschaulicht.The following table illustrates marshaling in a managed call to a native function, using platform invoke.

Parameter für verwaltete SignaturenManaged signature parameter Wert für "Wert"pArr value Gemarshallt alsMarshaled as
ErrorWrapper []-ParserErrorWrapper[] pArr ErrorWrapper [10] von ErrorWrapper (77)ErrorWrapper[10] of ErrorWrapper(77) Int[10]
Object []-ParserObject[] pArr ErrorWrapper [10] von ErrorWrapper (77)ErrorWrapper[10] of ErrorWrapper(77) VARIANT[10] von VT_ERRORVARIANT[10] of VT_ERROR
Object []-ParserObject[] pArr Objekt [10] von ErrorWrapper (77)Object[10] of ErrorWrapper(77) VARIANT[10] von VT_ERRORVARIANT[10] of VT_ERROR

In der folgenden Tabelle wird das Marshalling von Daten in einem verwalteten Aufruf an eine native Funktion mithilfe von com-Runtime Callable Wrapper (RCW) veranschaulicht.The following table illustrates marshaling data in a managed call to a native function, using COM runtime callable wrappers (RCW).

Parameter für verwaltete SignaturenManaged signature parameter Wert für "Wert"pArr value Gemarshallt alsMarshaled as
ErrorWrapper []-ParserErrorWrapper[] pArr ErrorWrapper [10] von ErrorWrapper (77)ErrorWrapper[10] of ErrorWrapper(77) Int[10]
Object []-ParserObject[] pArr ErrorWrapper [10] von ErrorWrapper (77)ErrorWrapper[10] of ErrorWrapper(77) SafeArrayTypeMismatchdistanzierenSafeArrayTypeMismatch exception
Object []-ParserObject[] pArr Objekt [10] von ErrorWrapper (77)Object[10] of ErrorWrapper(77) SAFEARRAY(VARIANT)

Beachten Sie ErrorWrapper , dass Objekte nicht als Typ VT_ERROR gemarshallt werden, nachdem Sie von com zurückgegeben wurden.Note that ErrorWrapper objects are not marshaled as type VT_ERROR after they are passed back from COM. Ein einzelner Wert wird von com als Typ VT_I4zurück gemarshallt, während Arrays von com als Typ VT_UI4zurück gemarshallt werden.A single value is marshaled back from COM as type VT_I4, while arrays are marshaled back from COM as type VT_UI4.

Weitere Informationen zu VT_ERRORfinden Sie in der vorhandenen Dokumentation für VARENUM::VT_ERROR in der MSDN Library.For more information on VT_ERROR, please see the existing documentation for VARENUM::VT_ERROR in the MSDN library.

Konstruktoren

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

Initialisiert eine neue Instanz der ErrorWrapper-Klasse mit dem entsprechenden HRESULT für die angegebene Ausnahme.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)

Initialisiert eine neue Instanz der ErrorWrapper-Klasse mit dem HRESULT des Fehlers.Initializes a new instance of the ErrorWrapper class with the HRESULT of the error.

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

Initialisiert eine neue Instanz der ErrorWrapper-Klasse mit einem Objekt, das das HRESULT des Fehlers enthält.Initializes a new instance of the ErrorWrapper class with an object containing the HRESULT of the error.

Eigenschaften

ErrorCode ErrorCode ErrorCode ErrorCode

Ruft den Fehlercode des Wrappers ab.Gets the error code of the wrapper.

Methoden

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

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

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

Fungiert als Standardhashfunktion.Serves as the default hash function.

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

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

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

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

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

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für: