Freigeben über

Marshal.GetIDispatchForObject-Methode

Gibt eine IDispatch-Schnittstelle aus einem verwalteten Objekt zurück.

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

Syntax

'Declaration
Public Shared Function GetIDispatchForObject ( _
    o As Object _
) As IntPtr
'Usage
Dim o As Object
Dim returnValue As IntPtr

returnValue = Marshal.GetIDispatchForObject(o)

public static IntPtr GetIDispatchForObject (
    Object o
)

public:
static IntPtr GetIDispatchForObject (
    Object^ o
)

public static IntPtr GetIDispatchForObject (
    Object o
)

public static function GetIDispatchForObject (
    o : Object
) : IntPtr

Parameter

  • o
    Das Objekt, dessen IDispatch-Schnittstelle angefordert wird.

Rückgabewert

Der IDispatch-Zeiger für den o-Parameter.

Ausnahmen

Ausnahmetyp Bedingung

InvalidCastException

o unterstützt die angeforderte Schnittstelle nicht.

Hinweise

In verwaltetem Code wird selten direkt mit der IDispatch-Schnittstelle gearbeitet. GetIDispatchForObject ist jedoch hilfreich beim Aufrufen einer Methode, die einen COM-Objektparameter als IntPtr-Typ verfügbar macht, sowie beim benutzerdefinierten Marshalling. Das Aufrufen eines Objekts mit dieser Methode bewirkt, dass der Verweiszähler für den Schnittstellenzeiger vor der Rückgabe des Zeigers inkrementiert wird. Verwenden Sie immer Marshal.Release, um den Verweiszähler zu dekrementieren, nachdem die Verarbeitung des Zeigers abgeschlossen ist.

Sie können diese Methode auch für ein verwaltetes Objekt verwenden, um einen Schnittstellenzeiger auf den COM-Aufrufwrapper des Objekts abzurufen. Weitere Informationen finden Sie unter COM Callable Wrapper (CCW).

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 CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, 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

.NET Compact Framework

Unterstützt in: 2.0

Siehe auch

Referenz

Marshal-Klasse
Marshal-Member
System.Runtime.InteropServices-Namespace
Release
GetIDispatchForObjectInContext

  • Last updated on