Marshal.QueryInterface(IntPtr, Guid, IntPtr) Methode

Definition

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Quelle:

Marshal.cs

Fordert einen Zeiger auf eine angegebene Schnittstelle von einem COM-Objekt an.

public:
 static int QueryInterface(IntPtr pUnk, Guid % iid, [Runtime::InteropServices::Out] IntPtr % ppv);

public static int QueryInterface (IntPtr pUnk, ref Guid iid, out IntPtr ppv);

static member QueryInterface : nativeint * Guid * nativeint -> int

Public Shared Function QueryInterface (pUnk As IntPtr, ByRef iid As Guid, ByRef ppv As IntPtr) As Integer

Parameter

pUnk

IntPtr

nativeint

Die abzufragende Schnittstelle.

iid

Guid

Der Schnittstellenbezeichner (Interface Identifier, IID) der angeforderten Schnittstelle.

ppv

IntPtr

nativeint

Enthält nach dem Beenden der Methode einen Verweis auf die zurückgegebene Schnittstelle.

Gibt zurück

Int32

Ein HRESULT, das den Erfolg oder Fehler des Aufrufs angibt.

Hinweise

Die QueryInterface -Methode macht die IUnknown::QueryInterface-Methode eines COM-Objekts verfügbar, die versucht, einen bestimmten Schnittstellenzeiger abzurufen. Die Verwendung QueryInterface in einem COM-Objekt entspricht der Ausführung eines Umwandlungsvorgangs in verwaltetem Code. 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. Um einen IntPtr Wert abzurufen, der einen IUnknown-Schnittstellenzeiger darstellt, können Sie , Marshal.GetIUnknownForObjectoder Marshal.GetIDispatchForObjectaufrufenMarshal.GetComInterfaceForObject.

Weitere Informationen

• AddRef(IntPtr)
• Release(IntPtr)
• GetComInterfaceForObject(Object, Type)
• GetIUnknownForObject(Object)
• GetIDispatchForObject(Object)
• GetObjectForIUnknown(IntPtr)