Marshal.GetObjectForIUnknown(IntPtr) Methode

Referenz

Definition

Namespace:: System.Runtime.InteropServices

Assembly:: System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Quelle:: Marshal.NoCom.cs

Quelle:: Marshal.NoCom.cs

Quelle:: Marshal.NoCom.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.

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

Object

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

Attribute: SecurityCriticalAttribute SupportedOSPlatformAttribute

Ausnahmen

ArgumentNullException

pUnk ist Zero

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:

Implementieren Sie die IProvideClassInfo-Schnittstelle für das COM-Objekt.
Registrieren Sie die enthaltende Assembly mit dem Regasm.exe (Assembly Registration Tool).

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: