struktur MULTI_QI (objidlbase.h)

  • Artikel

Mewakili antarmuka dalam kueri untuk beberapa antarmuka.

Sintaks

typedef struct tagMULTI_QI {
  const IID *pIID;
  IUnknown  *pItf;
  HRESULT   hr;
} MULTI_QI;

Anggota

pIID

Penunjuk ke pengidentifikasi antarmuka.

pItf

Penunjuk ke antarmuka yang diminta dalam pIID. Anggota ini harus NULL pada input.

hr

Nilai yang dikembalikan dari panggilan QueryInterface untuk menemukan antarmuka yang diminta. Nilai pengembalian umum mencakup S_OK dan E_NOINTERFACE. Anggota ini harus 0 pada input.

Keterangan

Untuk mengoptimalkan performa jaringan, sebagian besar fungsi aktivasi jarak jauh mengambil array struktur MULTI_QI daripada hanya satu IID sebagai input dan satu penunjuk ke antarmuka yang diminta pada objek sebagai output, seperti halnya fungsi aktivasi lokal. Ini memungkinkan satu set penunjuk ke antarmuka untuk dikembalikan dari objek yang sama dalam satu perjalanan pulang pergi ke server. Dalam skenario jaringan, meminta beberapa antarmuka pada saat konstruksi objek dapat menghemat banyak waktu selama menggunakan sejumlah panggilan ke QueryInterface untuk antarmuka unik, yang masing-masing akan memerlukan perjalanan pulang pergi ke server.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows 2000 Server [aplikasi desktop | Aplikasi UWP]
Header objidlbase.h (termasuk Objidl.h)

Lihat juga

CoCreateInstanceEx

CoGetInstanceFromFile

CoGetInstanceFromIStorage

IMultiQI