Auf Englisch lesen

Freigeben über


Marshal.GetIDispatchForObject(Object) Methode

Definition

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

C#
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static IntPtr GetIDispatchForObject(object o);
C#
public static IntPtr GetIDispatchForObject(object o);
C#
[System.Security.SecurityCritical]
public static IntPtr GetIDispatchForObject(object o);

Parameter

o
Object

Das Objekt, dessen IDispatch-Schnittstelle angefordert wird.

Gibt zurück

IntPtr

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

Attribute

Ausnahmen

o unterstützt die angeforderte Schnittstelle nicht.

Hinweise

In verwaltetem Code arbeiten Sie selten direkt mit der IDispatch Schnittstelle. Ist jedoch nützlich beim Aufrufen einer Methode, GetIDispatchForObject die einen COM-Objektparameter als IntPtr Typ verfügbar macht, oder beim benutzerdefinierten Marshalling. Das Aufrufen eines Objekts mit dieser Methode bewirkt, dass die Verweisanzahl auf dem Schnittstellenzeiger erhöht wird, bevor der Zeiger zurückgegeben wird. Verwenden Sie Marshal.Release immer, um die Verweisanzahl zu dekrementieren, sobald Sie mit dem Zeiger fertig sind.

Sie können diese Methode auch für ein verwaltetes Objekt verwenden, um einen Schnittstellenzeiger auf den COM-aufrufbaren Wrapper für das -Objekt abzurufen. Weitere Informationen finden Sie unter COM-Aufrufbarer Wrapper.

Gilt für:

Produkt Versionen
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.1

Weitere Informationen