This method queries the component for a specific interface.
If the component supports that interface, the reference count is incremented and the a pointer to the interface is returned for the caller to use.
- Note
- One of the weaknesses of COM is the typless nature of this method (ppIface being a P6VOID**). To help reduce this weakness, the VALIDATEIF macro should be used to ensure that the type pointed to in ppIface matches the interface type being requested.
- Parameters
-
iid | [ in ] The interface ID to query the component for. |
ppIface | [ out ] The address of a pointer variable that receives the interface pointer requested by the iid argument. On success *ppIface contains the requested interface pointer. If the requested interface is not supported, *ppIface will be set to NULL and eNoInterface will be returned directly. |
- Returns
Success | P6R::eOk | |
Failure | P6R::eAccessFault | ppIface is NULL |
P6R::eNoInterface | The requested interface was not found. |
- See Also
- VALIDATEIF