ErrorWrapper Klasse

Definition

Namespace:
System.Runtime.InteropServices
Assemblys:
mscorlib.dll, System.Runtime.InteropServices.dll
Assembly:
mscorlib.dll
Assembly:
System.Runtime.InteropServices.dll
Assembly:
netstandard.dll

Achtung

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

Umschließt Objekte, die der Marshaler als marshallen VT_ERRORsollte.

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

Das folgende Codebeispiel veranschaulicht zunächst ein einzelnes Int32 Objekt, das von COM als Int32 Objekt gemarstet wurde. Anschließend wird ein Int32 Array dargestellt, das von COM als UInt32 Array gemarstet 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 gemarstet, wobei der Objekttyp den VARTYPE Wert der VARIANT.

Der ErrorWrapper Typ muss als Object Typ übergeben werden, der als VARIANT Typ VT_ERRORgemarstet werden soll, andernfalls wird der ErrorWrapper Typ als ganze Zahl gemarstet.

In der folgenden Tabelle wird das Marshalling in einem verwalteten Aufruf einer systemeigenen Funktion mithilfe des Plattformaufrufs veranschaulicht.

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

Die folgende Tabelle veranschaulicht das Marshalling von Daten in einem verwalteten Aufruf einer systemeigenen Funktion mithilfe von COM-Runtime aufrufbaren Wrappern (RCW).

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

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

Weitere Informationen finden VT_ERRORSie in der vorhandenen Dokumentation VARENUM::VT_ERROR in der MSDN Library.

Konstruktoren

Name Beschreibung
ErrorWrapper(Exception)
Veraltet.

Initialisiert eine neue Instanz der ErrorWrapper Klasse mit dem HRESULT, das der bereitgestellten Ausnahme entspricht.
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

Name Beschreibung
ErrorCode
Veraltet.

Ruft den Fehlercode des Wrappers ab.

Methoden

Name Beschreibung
Equals(Object)
Veraltet.

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
GetHashCode()
Veraltet.

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()
Veraltet.

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()
Veraltet.

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ToString()
Veraltet.

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

(Geerbt von Object)

Gilt für: