4.1 RemUnknown::RemQueryInterface

QueryInterface for and return the result thereof for zero or more interfaces from the interface behind the IPID ipid. ipid must designate an interface derived from IUnknown (recall that all remoted interfaces must derive from IUnknown). The QueryInterface calls on the object that are used to service this request are conducted on the IUnknown interface of the object.

Argument Type Semantic
Ripid REFIPID The interface on an object fromwhom more interfaces are desired.
CRefs Unsigned long The number of references sought on each of the returned IIDs.
Ciids Unsigned short The interfaces being requested.
Iids IID* The list of IIDsthat name the interfaces sough on this object.
PpQIResults REMQUIRESULT** The place at which the arraay of the results of the various QueryInterface calls are returned.

ReturnValue Meaning
S_OK Success. An attempt was made to retrieve each of the  requested interfaces from the indicated object; that  is, QueryInterface was actually invoked for each IID.  QueryInterface returned S_OK for every IID specified.
S_FALSE                 Success. An attempt was made to retrieve each of the  requested interfaces from the indicated object; that is, QueryInterface was actually invoked for each IID.  QueryInterface returned a failure code for at least  one of the IIDs specified.
E_NOINTERFACE           QueryInterface returned a failure code for every IID  specifed.
E_INVALIDARG  One or more arguments (likely ipid) were invalid. No  result values are returned.
E_UNEXPECTED                     An unspecified error occurred
E_OUTOFMEMORY           Insufficient memory to complete the call.
RPC_E_INVALID_OBJECT    The requested object does not exist. No result values are returned.

4.1.1 REMQIRESULT

The REMQIRESULT structure contains the following members:

Member Type Semantic
HResult HRESULT The result code from the QueryInterface call made for the requested IID.
Std STDOBJREF The data for the returned interface.  Note that if hResult indicates failure then the contents of STDOBJREF are undefined.