ErrorWrapper Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 ErrorWrapperpublic 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 = classtype ErrorWrapper = class[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type ErrorWrapper = classPublic NotInheritable Class ErrorWrapper- Vererbung
-
ErrorWrapper
- Attribute
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) |
