Freigeben über


Marshal.GetObjectForIUnknown(IntPtr) Methode

Definition

Gibt eine Instanz eines Typs zurück, der ein COM-Objekt mit einem Zeiger auf die IUnknown-Schnittstelle darstellt.

public:
 static System::Object ^ GetObjectForIUnknown(IntPtr pUnk);
[System.Security.SecurityCritical]
public static object GetObjectForIUnknown (IntPtr pUnk);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static object GetObjectForIUnknown (IntPtr pUnk);
public static object GetObjectForIUnknown (IntPtr pUnk);
[<System.Security.SecurityCritical>]
static member GetObjectForIUnknown : nativeint -> obj
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member GetObjectForIUnknown : nativeint -> obj
static member GetObjectForIUnknown : nativeint -> obj
Public Shared Function GetObjectForIUnknown (pUnk As IntPtr) As Object

Parameter

pUnk
IntPtr

nativeint

Ein Zeiger auf die IUnknown-Schnittstelle.

Gibt zurück

Ein Objekt, das das angegebene nicht verwaltete COM-Objekt darstellt.

Attribute

Ausnahmen

Hinweise

Diese Methode umschließt IUnknown ein verwaltetes Objekt. Dies hat den Effekt, dass die Referenzanzahl der COM-Komponente erhöht wird. Die Verweisanzahl wird verringert, wenn die Runtime eine Garbage Collection für das verwaltete Objekt ausführt, das das COM-Objekt darstellt.

Der pUnk Parameter stellt einen IUnknown Schnittstellenzeiger dar. Da jedoch alle COM-Schnittstellen direkt oder indirekt von abgeleitet IUnknownwerden, können Sie jede COM-Schnittstelle an diese Methode übergeben. Das von GetObjectForIUnknown zurückgegebene Objekt ist ein Runtime Callable Wrapper, den die Common Language Runtime wie jedes andere verwaltete Objekt verwaltet. Der Typ dieses Wrappers ist häufig ein Basistyp System.__ComObject . Dabei handelt es sich um einen ausgeblendeten Typ, der verwendet wird, wenn der Wrappertyp mehrdeutig ist. Sie können immer noch spät gebundene Aufrufe für einen solchen Basistyp ausführen, solange das COM-Objekt die IDispatch-Schnittstelle implementiert. Ebenso können Sie das zurückgegebene Objekt in eine entsprechende COM-Schnittstelle umwandeln.

Damit ein Objekt mit einem bestimmten verwalteten Klassentyp (und nicht einem generischen Wrappertyp) umschlossen wird, müssen Sie die folgenden Anforderungen erfüllen:

Alternativ können Sie diese Anforderungen vermeiden und trotzdem ein Objekt abrufen, das mit einem bestimmten verwalteten Klassentyp umschlossen wird, indem Sie die Marshal.GetTypedObjectForIUnknown -Methode verwenden.

Gilt für:

Weitere Informationen