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