Freigeben über

Marshal.SetComObjectData-Methode

Legt Daten fest, auf die durch den angegebenen Schlüssel im angegebenen COM-Objekt verwiesen wird.

Namespace: System.Runtime.InteropServices
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Shared Function SetComObjectData ( _
    obj As Object, _
    key As Object, _
    data As Object _
) As Boolean
'Usage
Dim obj As Object
Dim key As Object
Dim data As Object
Dim returnValue As Boolean

returnValue = Marshal.SetComObjectData(obj, key, data)

public static bool SetComObjectData (
    Object obj,
    Object key,
    Object data
)

public:
static bool SetComObjectData (
    Object^ obj, 
    Object^ key, 
    Object^ data
)

public static boolean SetComObjectData (
    Object obj, 
    Object key, 
    Object data
)

public static function SetComObjectData (
    obj : Object, 
    key : Object, 
    data : Object
) : boolean

Parameter

  • obj
    Das COM-Objekt, in dem die Daten gespeichert werden sollen.
  • key
    Der Schlüssel in der internen Hashtabelle des COM-Objekts, in dem die Daten gespeichert werden sollen.
  • data
    Die festzulegenden Daten.

Rückgabewert

true, wenn die Daten erfolgreich festgelegt wurden, andernfalls false.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentNullException

obj ist NULL (Nothing in Visual Basic).

- oder -

key ist NULL (Nothing in Visual Basic).

ArgumentException

obj ist kein COM-Objekt.

Hinweise

Alle in einem RCW (Runtime Callable Wrapper) gewrappten COM-Objekte besitzen eine zugeordnete Hashtabelle, der durch SetComObjectData Daten hinzugefügt werden. Marshal.GetComObjectData ruft Daten aus der Hashtabelle ab. Keine dieser Methode muss aus dem Code aufgerufen werden.

Hinweis

Diese Methode verwendet SecurityAction.LinkDemand, um einen Aufruf aus nicht vertrauenswürdigem Code zu verhindern. Nur der direkte Aufrufer muss über die SecurityPermissionAttribute.UnmanagedCode-Berechtigung verfügen. Wenn der Code aus teilweise vertrauenswürdigem Code aufgerufen werden kann, dürfen Benutzereingaben nicht ohne Validierung an Methoden der Marshal-Klasse übergeben werden. Wichtige Einschränkungen bei der Verwendung des LinkDemand-Members finden Sie unter "Demand" und "LinkDemand".

.NET Framework-Sicherheit

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Marshal-Klasse
Marshal-Member
System.Runtime.InteropServices-Namespace
GetComObjectData

  • Last updated on