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

Definición

Espacio de nombres:

System.Runtime.InteropServices

Ensamblado:

System.Runtime.InteropServices.dll

Source:

Marshal.cs

Solicita un puntero a una interfaz especificada de un objeto 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

Parámetros

pUnk

IntPtr

nativeint

Interfaz que se va a consultar.

iid

Guid

Identificador de interfaz (IID) de la interfaz solicitada.

ppv

IntPtr

nativeint

Cuando este método finaliza, contiene una referencia a la interfaz devuelta.

Devoluciones

Int32

HRESULT que indica si la llamada se realizó correctamente o no.

Comentarios

El QueryInterface método expone el método IUnknown::QueryInterface de un objeto COM, que intenta obtener un puntero de interfaz específico. El uso QueryInterface de en un objeto COM es el mismo que realizar una operación de conversión en código administrado. Llamar a un objeto con este método hace que el recuento de referencias aumente en el puntero de interfaz antes de que se devuelva el puntero. Marshal.Release Use siempre para disminuir el recuento de referencias una vez que haya terminado con el puntero. Para obtener un IntPtr valor que representa un puntero de interfaz IUnknown , puede llamar a Marshal.GetComInterfaceForObject, Marshal.GetIUnknownForObjecto Marshal.GetIDispatchForObject.

Consulte también

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