ErrorWrapper Klasse

  • Referenz

Definition

Namespace:
System.Runtime.InteropServices
Assembly:
System.Runtime.InteropServices.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Quelle:
ErrorWrapper.cs
Quelle:
ErrorWrapper.cs
Quelle:
ErrorWrapper.cs

Achtung

ErrorWrapper and support for marshalling to the VARIANT type may be unavailable in future releases.

Erstellt einen Wrapper für Objekte, die der Marshaller als VT_ERROR marshallen soll.

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
Vererbung
Object
ErrorWrapper
Attribute
ObsoleteAttribute ComVisibleAttribute SerializableAttribute

Beispiele

Im folgenden Codebeispiel wird zunächst ein einzelnes Int32 Objekt veranschaulicht, das von COM als Int32 Objekt gemarst wird. Anschließend wird ein Int32 Array veranschaulicht, das von COM als UInt32 Array zurückgepferst wird.

// 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 als VARIANT Typ gemarst, wobei der Objekttyp den VARTYPE Wert von VARIANTbestimmt.

Der ErrorWrapper Typ muss als Typ Object übergeben werden, um als vom VARIANT Typ VT_ERRORgemarst werden zu können, andernfalls wird der ErrorWrapper Typ als ganze Zahl gemarst.

In der folgenden Tabelle wird das Marshallen in einem verwalteten Aufruf an eine native Funktion mithilfe des Plattformaufrufs veranschaulicht.

Parameter für verwaltete Signatur pArr-Wert Gemarst als
ErrorWrapper[] pArr ErrorWrapper[10] von ErrorWrapper(77) Int[10]
Objekt[] pArr ErrorWrapper[10] von ErrorWrapper(77) VARIANT[10] von VT_ERROR
Objekt[] pArr Objekt[10] von ErrorWrapper(77) VARIANT[10] von VT_ERROR

Die folgende Tabelle veranschaulicht das Marshallen von Daten in einem verwalteten Aufruf an eine native Funktion mithilfe von AUFRUFBAREN WRAPPERN (COM Runtime Callable Wrappers, RCW).

Parameter für verwaltete Signatur pArr-Wert Gemarst als
ErrorWrapper[] pArr ErrorWrapper[10] von ErrorWrapper(77) Int[10]
Objekt[] pArr ErrorWrapper[10] von ErrorWrapper(77) SafeArrayTypeMismatch-Ausnahme
Objekt[] pArr Objekt[10] von ErrorWrapper(77) SAFEARRAY(VARIANT)

Beachten Sie, dass ErrorWrapper Objekte nicht als Typ gemarst werden, VT_ERROR nachdem sie von COM zurückgegeben wurden. Ein einzelner Wert wird von COM als Typ VT_I4gemarst, während Arrays von COM als Typ VT_UI4gemarst werden.

Weitere Informationen zu VT_ERRORfinden Sie in der vorhandenen Dokumentation in VARENUM::VT_ERROR der MSDN Library.

Konstruktoren

ErrorWrapper(Exception)
Veraltet.

Initialisiert eine neue Instanz der ErrorWrapper-Klasse mit dem entsprechenden HRESULT für die angegebene Ausnahme.
ErrorWrapper(Int32)
Veraltet.

Initialisiert eine neue Instanz der ErrorWrapper-Klasse mit dem HRESULT des Fehlers.
ErrorWrapper(Object)
Veraltet.

Initialisiert eine neue Instanz der ErrorWrapper-Klasse mit einem Objekt, das das HRESULT des Fehlers enthält.

Eigenschaften

ErrorCode
Veraltet.

Ruft den Fehlercode des Wrappers ab.

Methoden

Equals(Object)
Veraltet.

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()
Veraltet.

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()
Veraltet.

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()
Veraltet.

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()
Veraltet.

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für: