MULTI_QI 结构 (objidl.h)

表示查询中针对多个接口的接口。

语法

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

成员

pIID

指向接口标识符的指针。

pItf

指向 pIID 中请求的接口的指针。 此成员在输入时必须为 NULL

hr

用于查找所请求接口的 QueryInterface 调用的返回值。 常见的返回值包括S_OK和E_NOINTERFACE。 输入时,此成员必须为 0。

注解

为了优化网络性能,大多数远程激活函数采用 一组MULTI_QI 结构,而不仅仅是一个 IID 作为输入,将单个指针作为对象上请求的接口作为输出,本地激活函数也一样。 这允许在到服务器的一次往返中从同一对象返回一组指向接口的指针。 在网络方案中,在对象构造时请求多个接口可以节省大量针对唯一接口的 QueryInterface 调用,每个调用都需要往返于服务器。

要求

要求
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
标头 objidl.h (包括 Objidl.h)

另请参阅

CoCreateInstanceEx

CoGetInstanceFromFile

CoGetInstanceFromIStorage

IMultiQI