virtual P6R::P6ERR P6R::p6ICom::queryInterface ( const P6R::IID iid,
P6R::P6VOID **  ppIface 
) [pure virtual, inherited]

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:
SuccessP6R::eOk 
FailureP6R::eAccessFaultppIface is NULL
P6R::eNoInterfaceThe requested interface was not found.
See also:
VALIDATEIF
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Defines
Copyright © 2004 - 2010 P6R Inc. - All Rights Reserved.