structure MULTI_QI (objidlbase.h)

Représente une interface dans une requête pour plusieurs interfaces.

Syntaxe

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

Membres

pIID

Pointeur vers un identificateur d’interface.

pItf

Pointeur vers l’interface demandée dans pIID . Ce membre doit être NULL lors de l’entrée.

hr

Valeur de retour de l’appel QueryInterface pour localiser l’interface demandée. Les valeurs de retour courantes incluent S_OK et E_NOINTERFACE. Ce membre doit être 0 lors de l’entrée.

Remarques

Pour optimiser les performances du réseau, la plupart des fonctions d’activation à distance prennent un tableau de structures MULTI_QI plutôt qu’un seul IID comme entrée et un pointeur unique vers l’interface demandée sur l’objet en tant que sortie, comme les fonctions d’activation locales. Cela permet à un ensemble de pointeurs vers des interfaces d’être retournés à partir du même objet dans un seul aller-retour vers le serveur. Dans les scénarios réseau, la demande de plusieurs interfaces au moment de la construction d’objets peut gagner beaucoup de temps à l’aide d’un certain nombre d’appels pour QueryInterface pour les interfaces uniques, chacune nécessitant un aller-retour vers le serveur.

Exigences

Voir aussi

CoCreateInstanceEx

CoGetInstanceFromFile

CoGetInstanceFromIStorage

IMultiQI