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

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 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:

Freigeben über