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

Définition

Espace de noms:

System.Runtime.InteropServices

Assemblys:

netstandard.dll, System.Runtime.InteropServices.dll

Source:

Marshal.cs

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

C#

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

Paramètres

pUnk

IntPtr

Interface à interroger.

iid

Guid

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

ppv

IntPtr

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 de sur un objet COM est identique à l’exécution d’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.

S’applique à

Voir aussi

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