extend_object< BASE_OBJECT, EXTEND_INTERFACE, Child >

Used to implement IObject::GetInterface() methods with given interfaces to expose. More...

Inheritance diagram for extend_object< BASE_OBJECT, EXTEND_INTERFACE, Child >:

Public Types
typedef BASE_OBJECT	base_type
	base object type

Protected Member Functions
virtual	~extend_object ()
	Virtual destructor needed for call to this->Destroy()
virtual tResult	GetInterface (const char *i_strIID, void *&o_pInterface)
	Default implementation of IObject::GetInterface() More...
virtual tResult	GetInterface (const char *i_strIID, const void *&o_pInterface) const
	Default implementation of IObject::GetInterface() provided for const correctness. More...
virtual void	Destroy () const
	Default implementation to destroy an object of this type.

Detailed Description

template<typename BASE_OBJECT, typename EXTEND_INTERFACE, typename Child>
class adtf::ucom::ant::extend_object< BASE_OBJECT, EXTEND_INTERFACE, Child >

Used to implement IObject::GetInterface() methods with given interfaces to expose.

Template Parameters

BASE_OBJECT	The implemented object to extend.
EXTEND_INTERFACE	The interface to extend the BASE_OBJECT with.
If	multiple inheritance leads to ambiguous calls, use a hierarchy here. Otherwise only EXTEND_INTERFACE is allowed.
Child	Child type of this extend_object and is only needed if UCOM_RESOLVE() is given in child class Child.

This template class is intended as subclass of a concrete implementation of IObject. When inheriting from this class, two template parameters of type inherit_from and expose_interfaces, both being variadic templates themselves, must be given. With struct inherit_from those types are given which default_object itself uses as its parents in form of multiple inheritance. As default_object itself must be inherited by the concrete implementation of the given subclassed interfaces, it marks some kind of intermediate layer only used to implement IObject::GetInterface() methods. With struct expose_interfaces the interfaces to expose are given.

See also

Section The "elaborate" way (aka "object<>") in page The ucom_cast<> in depth explanation

Definition at line 727 of file adtf_iid.h.

Member Function Documentation

GetInterface() [1/2]

virtual tResult GetInterface ( const char *  i_strIID, const void *&  o_pInterface  ) const

inlineprotectedvirtual

Default implementation of IObject::GetInterface() provided for const correctness.

Using the interface types given with expose_interfaces, meta struct template interface_expose is used to evaluate whether the interface identified with i_strIID is exposed by this.

Parameters

[in]	i_strIID	Identifier of the interface being requested.
[out]	o_pInterface	Address of pointer variable that receives the interface pointer requested in idInterface. Upon successful return, *o_pInterface contains the requested interface pointer to the object. If the object does not expose the interface specified in i_strIID, i_pInterface is set to NULL.

Returns

Standard error.

Return values

ERR_NOERROR	The interface identified by i_strIID was implemented and exposed by the implementation of *this. o_pInterface points to the queried interface.
ERR_NO_INTERFACE	The requested interface is not exposed. o_pInterface==NULL

Definition at line 781 of file adtf_iid.h.

References IS_FAILED, and RETURN_NOERROR.

GetInterface() [2/2]

virtual tResult GetInterface ( const char *  i_strIID, void *&  o_pInterface  )

inlineprotectedvirtual

Default implementation of IObject::GetInterface()

Using the interface types given with expose_interfaces, meta struct template interface_expose is used to evaluate whether the interface identified with i_strIID is exposed by this.

Parameters

[in]	i_strIID	Identifier of the interface being requested.
[out]	o_pInterface	Address of pointer variable that receives the interface pointer requested in idInterface. Upon successful return, *o_pInterface contains the requested interface pointer to the object. If the object does not expose the interface specified in i_strIID, i_pInterface is set to NULL.

Returns

Standard error.

Return values

ERR_NOERROR	The interface identified by i_strIID was implemented and exposed by the implementation of *this. o_pInterface points to the queried interface.
ERR_NO_INTERFACE	The requested interface is not exposed. o_pInterface==NULL

Definition at line 753 of file adtf_iid.h.

References IS_FAILED, and RETURN_NOERROR.