struktur MULTI_QI (objidl.h)

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 pengembalian panggilan QueryInterface untuk menemukan antarmuka yang diminta. Nilai pengembalian umum termasuk 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

Lihat juga

CoCreateInstanceEx

CoGetInstanceFromFile

CoGetInstanceFromIStorage

IMultiQI