Marshal.QueryInterface(IntPtr, Guid, IntPtr) Méthode

Définition

Espace de noms:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Source:

Marshal.cs

Demande un pointeur vers une interface spécifiée à partir d'un objet COM.

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

Paramètres

pUnk

IntPtr

nativeint

Interface à interroger.

iid

Guid

Identificateur d'interface (IID) de l'interface demandée.

ppv

IntPtr

nativeint

Lorsque cette méthode est retournée, contient une référence à l'interface retournée.

Retours

Int32

HRESULT indiquant la réussite ou l'échec de l'appel.

Remarques

La QueryInterface méthode expose la méthode IUnknown::QueryInterface d’un objet COM, qui tente d’obtenir un pointeur d’interface spécifique. L’utilisation QueryInterface sur un objet COM équivaut à effectuer une opération de cast dans du code managé. L’appel d’un objet avec cette méthode entraîne l’incrémentation du nombre de références sur le pointeur d’interface avant que le pointeur ne soit retourné. Marshal.Release Utilisez toujours pour décrémenter le nombre de références une fois que vous avez terminé avec le pointeur. Pour obtenir une IntPtr valeur qui représente un pointeur d’interface IUnknown , vous pouvez appeler Marshal.GetComInterfaceForObject, Marshal.GetIUnknownForObjectou Marshal.GetIDispatchForObject.

Voir aussi

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