Marshal.QueryInterface(IntPtr, Guid, IntPtr) Metode

Definisi

Ruang nama:

System.Runtime.InteropServices

Rakitan:

System.Runtime.InteropServices.dll

Sumber:

Marshal.cs

Meminta penunjuk ke antarmuka tertentu dari objek 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

Parameter

pUnk

IntPtr

nativeint

Antarmuka yang akan dikueri.

iid

Guid

Pengidentifikasi antarmuka (IID) dari antarmuka yang diminta.

ppv

IntPtr

nativeint

Ketika metode ini kembali, berisi referensi ke antarmuka yang dikembalikan.

Mengembalikan

Int32

HRESULT yang menunjukkan keberhasilan atau kegagalan panggilan.

Keterangan

Metode ini QueryInterface mengekspos metode IUnknown::QueryInterface dari objek COM, yang mencoba mendapatkan penunjuk antarmuka tertentu. Menggunakan QueryInterface pada objek COM sama dengan melakukan operasi transmisi dalam kode terkelola. Memanggil objek dengan metode ini menyebabkan jumlah referensi bertambah pada penunjuk antarmuka sebelum penunjuk dikembalikan. Selalu gunakan Marshal.Release untuk mengurangi jumlah referensi setelah Anda selesai dengan penunjuk. Untuk mendapatkan IntPtr nilai yang mewakili penunjuk antarmuka IUnknown , Anda dapat memanggil Marshal.GetComInterfaceForObject, , Marshal.GetIUnknownForObjectatau Marshal.GetIDispatchForObject.

Lihat juga

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