The MULTI_QI class of the com.ms.com package optimizes network performance by providing multiple interface pointers to remote activation functions. This is better than providing a single IID as input and a single pointer to the requested interface on the object as output, as do local computer activation functions. This allows a set of pointers to interfaces to be returned from the same object in a single round-trip to the server. In network scenarios, requesting multiple interfaces at the time of object construction can save considerable time over using a number of calls to the QueryInterface method for unique interfaces, each of which would require a round-trip to the server.
Note The MULTI_QI class was added as of versions 2925 through 3167 of the Microsoft virtual machine.
public class MULTI_QI { // Members public _Guid pIID; public IUnknown pItf; public int hr; }
[in] pIID | The pointer to an interface identifier. |
[out] pItf | The pointer to the interface requested in pIID. Must be set to NULL on entry. |
[out] hr | The return value of the QueryInterface call made to satisfy the request for the interface requested in pIID. Common return values are S_OK and E_NOINTERFACE. Must be set to 0 (zero) on entry. |