sl@0: // Copyright (c) 2007-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0: // All rights reserved.
sl@0: // This component and the accompanying materials are made available
sl@0: // under the terms of "Eclipse Public License v1.0"
sl@0: // which accompanies this distribution, and is available
sl@0: // at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0: //
sl@0: // Initial Contributors:
sl@0: // Nokia Corporation - initial contribution.
sl@0: //
sl@0: // Contributors:
sl@0: //
sl@0: // Description:
sl@0: // The implementation of some classes to be provided by ECom.
sl@0: // 
sl@0: //
sl@0: 
sl@0: /**
sl@0:  @file
sl@0:  @internalComponent
sl@0: */
sl@0: 
sl@0: #include "exampletwelve.h"
sl@0: 
sl@0: // __________________________________________________________________________
sl@0: //
sl@0: // Implementation of CImplementationClassTwelve
sl@0: 
sl@0: /**
sl@0: Safe construction which leaves nothing upon the cleanup stack
sl@0: @param			aInitParams Initialization parameters
sl@0: @return			CImplementationClassTwelve* a pointer to the fully instantiated CImplementationClassTwelve object
sl@0: */
sl@0: CImplementationClassTwelve* CImplementationClassTwelve::NewL(TAny* aInitParams)
sl@0: 	{
sl@0: 	CImplementationClassTwelve* self=new(ELeave) CImplementationClassTwelve(); 
sl@0: 	CleanupStack::PushL(self);	
sl@0: 	self->ConstructL(aInitParams);
sl@0: 	CleanupStack::Pop(self);
sl@0: 	return self;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Destructor of CImplementationClassTwelve
sl@0:  */
sl@0: CImplementationClassTwelve::~CImplementationClassTwelve()
sl@0: 	{
sl@0: 	delete iInternalDescriptor;
sl@0: 	Dll::SetTls(NULL);
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Default Constructor : usable only by derived classes
sl@0: */
sl@0: CImplementationClassTwelve::CImplementationClassTwelve()
sl@0: : CExampleInterface()
sl@0: 	{
sl@0: 	//set the extended interface Uid
sl@0: 	iExtendedInterfaceUid.iUid = 0x10009E44;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Safely complete the initialization of the constructed object.
sl@0: @param			aInitParams Initialization parameters
sl@0: */
sl@0: void CImplementationClassTwelve::ConstructL(TAny* aInitParams)
sl@0: 	{
sl@0: 	TExampleInterfaceInitParams* params = REINTERPRET_CAST(TExampleInterfaceInitParams*,aInitParams);
sl@0: 	if(params)
sl@0: 		{
sl@0: 		if(params->descriptor)
sl@0: 			{
sl@0: 			iInternalDescriptor = params->descriptor->AllocL();
sl@0: 			}
sl@0: 		}
sl@0: 	User::LeaveIfError(Dll::SetTls(&iTLSInt));
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Overload of the pure interface method.Representative of a method provided on
sl@0: the interface by the interface definer.
sl@0:  */
sl@0: void CImplementationClassTwelve::DoMethodL()
sl@0: 	{
sl@0: 	// Access TLS to ensure it has been set properly
sl@0: 	ASSERT(Dll::Tls()!=NULL);
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Overload of the pure interface method asynchronous function which
sl@0: an interface definer could specify.
sl@0: @return			TInt KErrNone for success.
sl@0:  */
sl@0: TInt CImplementationClassTwelve::FireAndForget()
sl@0: 	{
sl@0: 	return KErrNone;			
sl@0: 	}
sl@0: 
sl@0: // Provide the CActive overloads
sl@0: void CImplementationClassTwelve::RunL()
sl@0: 	{
sl@0: 	// Do nothing : should never be called
sl@0: 	__ASSERT_DEBUG(EFalse,User::Invariant());
sl@0: 	}
sl@0: 
sl@0: void CImplementationClassTwelve::DoCancel()
sl@0: 	{
sl@0: 	// Do nothing
sl@0: 	}
sl@0: 
sl@0: TInt CImplementationClassTwelve::RunError(TInt /*aError*/)
sl@0: 	{
sl@0: 	return KErrNone;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: To verify the object returned by ECOM.
sl@0: @return			TUid (ECOM's Implementation Uid for this class.)
sl@0:  */
sl@0: TUid CImplementationClassTwelve::ImplId()
sl@0: 	{
sl@0: 	return KImplUid1;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Extended interface method. Called to verify the Extended interface.
sl@0:  */
sl@0: void CImplementationClassTwelve::DoMethodExtended()
sl@0: 	{
sl@0: 	//check the extended interface uid has been set properly
sl@0: 	ASSERT(iExtendedInterfaceUid.iUid == 0x10009E44);
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Get the extended interface. This method will be called by ECOM, so the method must
sl@0: follow the signature defined by TProxyExtendedInterfaceGetPtrL. This must be a static
sl@0: method since it is used in the proxy table.
sl@0: @param			aObject A pointer to the instantiation interface (CImplementationClassTwelve
sl@0: 				in this case) instance. This will be provided by ECOM. It must be provided
sl@0: 				as a parameter,	as this method is a static method (and must be a static
sl@0: 				method because it is called by the proxy table).
sl@0: @param			aExtendedInterface The extended interface to fetch. Must be a unique UID.
sl@0: @param			aBitFlags Flags used for communication between plugin's and ECOM. Currently
sl@0: 				used to signal if an extended interface requires release.
sl@0: @param			aReleaseObject return parameter, provides ECOM with the object to destroy
sl@0: 				if the interface requires to be released.
sl@0: @return			TAny* a pointer to the fully constructed extended interface object
sl@0: */
sl@0: TAny* CImplementationClassTwelve::GetExtendedInterfaceL(TAny* aObject,const TUid& aExtendedInterface,TUint32& aBitFlags,TAny*& aReleaseObject)
sl@0: 
sl@0: 	{
sl@0: 	//Initialise the release bit
sl@0: 	aBitFlags = aBitFlags & 0xFFFFFFFE;
sl@0: 	TAny* ret = NULL;
sl@0: 	switch (aExtendedInterface.iUid)
sl@0: 		{
sl@0: 		case 0x10009E44:
sl@0: 		    {
sl@0: 	        // No release is required, so do not modify aBitFlags.
sl@0: 		    ret = static_cast<MExampleInterfaceExtended*>(static_cast<CImplementationClassTwelve*>(aObject));
sl@0: 		    break;
sl@0: 		    }
sl@0: 		case 0x10009E45:
sl@0: 		    {
sl@0: 		    // Indicate to caller that release is required
sl@0: 		    aBitFlags = aBitFlags | KReleaseRequiredMask;
sl@0: 
sl@0: 		    CImplementationClassTwelveExtended *classExt = CImplementationClassTwelveExtended::NewL();
sl@0: 		    // Must set the release object for ECOM to release later, this will not be the same as the interface object that is returned.
sl@0: 		    aReleaseObject = classExt;
sl@0: 
sl@0: 		    ret = static_cast<MExampleInterfaceExtended2*>(classExt);
sl@0: 		    break;
sl@0: 		    }
sl@0: 		case 0x10009E46:
sl@0: 		    {
sl@0: 		    // Indicate to caller that release is required
sl@0: 		    aBitFlags = aBitFlags | KReleaseRequiredMask;
sl@0: 
sl@0: 		    CImplementationClassTwelveExtended2 *classExt = CImplementationClassTwelveExtended2::NewL();
sl@0: 		    // Must set the release object for ECOM to release later, this will not be the same as the interface object that is returned.
sl@0: 		    aReleaseObject = classExt;
sl@0: 
sl@0: 		    ret = static_cast<MExampleInterfaceExtended2*>(classExt);
sl@0: 		    break;
sl@0: 		    }
sl@0: 		default:
sl@0: 			{
sl@0: 		    break;
sl@0: 		    }
sl@0: 		}
sl@0: 	return ret;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Release the specified extended interface. This method will be called by ECOM, so the method must
sl@0: follow the signature defined by TProxyExtendedInterfaceReleasePtr. This must be a static
sl@0: method since it is used in the proxy table.
sl@0: method.
sl@0: @param			aReleaseObject provides ECOM with the object to destroy
sl@0: 				if the interface requires to be released.
sl@0: @param			aExtendedInterface extended interface that is to be released
sl@0: @return			TAny* a pointer to the fully constructed extended interface object
sl@0: */
sl@0: void CImplementationClassTwelve::ReleaseExtendedInterface(TAny* aReleaseObject,const TUid& aExtendedInterface)
sl@0: 	{
sl@0: 	switch (aExtendedInterface.iUid)
sl@0: 	    {
sl@0: 	    case 0x10009E45:
sl@0: 			{
sl@0: 	        // this object is an interface that was a separate object from the main instantiated object, and must be cleaned up.
sl@0: 			CImplementationClassTwelveExtended* classExt = static_cast<CImplementationClassTwelveExtended*>(aReleaseObject);
sl@0: 			delete classExt;
sl@0: 			break;
sl@0: 	        }
sl@0:  		case 0x10009E46:
sl@0: 			{
sl@0: 	        // this object is an interface that was a separate object from the main instantiated object, and must be cleaned up.
sl@0: 			CImplementationClassTwelveExtended2* classExt = static_cast<CImplementationClassTwelveExtended2*>(aReleaseObject);
sl@0: 			delete classExt;
sl@0: 			break;
sl@0: 	        }
sl@0: 	    default:
sl@0: 			{
sl@0: 			break;    
sl@0: 			}    
sl@0: 	    }
sl@0: 	}
sl@0: 
sl@0: 
sl@0: // __________________________________________________________________________
sl@0: //
sl@0: // Implementation of CImplementationClassTwelveExtended
sl@0: 
sl@0: /**
sl@0: Safe construction which leaves nothing upon the cleanup stack
sl@0: @return			CImplementationClassTwelve* a pointer to the fully instantiated CImplementationClassTwelve object
sl@0: */
sl@0: CImplementationClassTwelveExtended* CImplementationClassTwelveExtended::NewL()
sl@0: 
sl@0: 	{
sl@0: 	CImplementationClassTwelveExtended* self=new(ELeave) CImplementationClassTwelveExtended();  // calls c'tor
sl@0: 	return self;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Destructor of CImplementationClassTwelveExtended
sl@0:  */
sl@0: CImplementationClassTwelveExtended::~CImplementationClassTwelveExtended()
sl@0: 	{
sl@0: 	// do nothing
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Default Constructor : usable only by derived classes
sl@0: */
sl@0: CImplementationClassTwelveExtended::CImplementationClassTwelveExtended()
sl@0: 	{
sl@0: 	//set the extended interface uid
sl@0: 	iExtendedInterfaceUid.iUid = 0x10009E45;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Extended interface.
sl@0: */
sl@0: void CImplementationClassTwelveExtended::DoMethodExtended2()
sl@0: 	{
sl@0: 	//check the extended interface uid has been set properly
sl@0: 	ASSERT(iExtendedInterfaceUid.iUid == 0x10009E45);
sl@0: 	}
sl@0: 
sl@0: // __________________________________________________________________________
sl@0: //
sl@0: // Implementation of CImplementationClassTwelveExtended2
sl@0: 
sl@0: /**
sl@0: Safe construction which leaves nothing upon the cleanup stack
sl@0: @return			CImplementationClassTwelveExtended2* a pointer to the fully instantiated CImplementationClassTwelve object
sl@0: */
sl@0: CImplementationClassTwelveExtended2* CImplementationClassTwelveExtended2::NewL()
sl@0: 	{
sl@0: 	CImplementationClassTwelveExtended2* self=new(ELeave) CImplementationClassTwelveExtended2();  // calls c'tor
sl@0: 	return self;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Destructor of CImplementationClassTwelveExtended2
sl@0:  */
sl@0: CImplementationClassTwelveExtended2::~CImplementationClassTwelveExtended2()
sl@0: 	{
sl@0: 	// do nothing
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Default Constructor : usable only by derived classes
sl@0: */
sl@0: CImplementationClassTwelveExtended2::CImplementationClassTwelveExtended2()
sl@0: 	{
sl@0: 	//set the extended interface uid
sl@0: 	iExtendedInterfaceUid.iUid = 0x10009E46;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Extended interface.
sl@0: */
sl@0: void CImplementationClassTwelveExtended2::DoMethodExtended2()
sl@0: 	{
sl@0: 	//check the extended interface uid has been set properly
sl@0: 	ASSERT(iExtendedInterfaceUid.iUid == 0x10009E46);
sl@0: 	}
sl@0: 
sl@0: 
sl@0: // __________________________________________________________________________
sl@0: // Implementation of CImplementationClassTwelveBasic
sl@0: 
sl@0: /**
sl@0: Safe construction which leaves nothing upon the cleanup stack
sl@0: @param			aInitParams The parameter struct used for initialising this object
sl@0: @return			CImplementationClassTwelveBasic* a pointer to the fully instantiated CImplementationClassTwelveBasic object
sl@0: */
sl@0: CImplementationClassTwelveBasic* CImplementationClassTwelveBasic::NewL(TAny* aInitParams)
sl@0: 	{
sl@0: 	CImplementationClassTwelveBasic* self=new(ELeave) CImplementationClassTwelveBasic();  
sl@0: 	CleanupStack::PushL(self);	
sl@0: 	self->ConstructL(aInitParams); 
sl@0: 	CleanupStack::Pop(self);
sl@0: 	return self;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Destructor of CImplementationClassTwelveBasic
sl@0:  */
sl@0: CImplementationClassTwelveBasic::~CImplementationClassTwelveBasic()
sl@0: 	{
sl@0: 	delete iInternalDescriptor;
sl@0: 	Dll::FreeTls();
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Default Constructor : usable only by derived classes
sl@0: */
sl@0: CImplementationClassTwelveBasic::CImplementationClassTwelveBasic()
sl@0: : CExampleInterface()
sl@0: 	{
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Completes the safe construction of the CImplementationClassTwelveBasic object
sl@0: @param			aInitParams The parameter struct used for initialising this object
sl@0:  */
sl@0: void CImplementationClassTwelveBasic::ConstructL(TAny* aInitParams)
sl@0: 	{
sl@0: 	TExampleInterfaceInitParams* params = REINTERPRET_CAST(TExampleInterfaceInitParams*, aInitParams);
sl@0: 	if(params)
sl@0: 		{
sl@0: 		if(params->descriptor)
sl@0: 			{
sl@0: 			iInternalDescriptor = params->descriptor->AllocL();
sl@0: 			}
sl@0: 		}
sl@0: 	User::LeaveIfError(Dll::SetTls(&iTLSInt));
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Overload of the pure interface method.Representative of a method provided on
sl@0: the interface by the interface definer.
sl@0:  */
sl@0: void CImplementationClassTwelveBasic::DoMethodL()
sl@0: 	{
sl@0: 	// Access TLS to ensure it has been set properly
sl@0: 	ASSERT(Dll::Tls() != NULL);
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Overload of the pure interface method asynchronous function which
sl@0: an interface definer could specify. 
sl@0: @return			TInt KErrNone for success.
sl@0:  */
sl@0: TInt CImplementationClassTwelveBasic::FireAndForget()
sl@0: 	{
sl@0: 	return KErrNone;			
sl@0: 	}
sl@0: 
sl@0: // Provide the CActive overloads
sl@0: void CImplementationClassTwelveBasic::RunL()
sl@0: 	{
sl@0: 	// Do nothing : should never be called
sl@0: 	__ASSERT_DEBUG(EFalse,User::Invariant());
sl@0: 	}
sl@0: 
sl@0: void CImplementationClassTwelveBasic::DoCancel()
sl@0: 	{
sl@0: 	// Do nothing
sl@0: 	}
sl@0: 
sl@0: TInt CImplementationClassTwelveBasic::RunError(TInt /*aError*/)
sl@0: 	{
sl@0: 	return KErrNone;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: To verify the object returned by ECOM.
sl@0: @return			TUid (ECOM's Implementation Uid for this class.)
sl@0:  */
sl@0: TUid CImplementationClassTwelveBasic::ImplId()
sl@0: 	{
sl@0: 	return KImplUid2;
sl@0: 	}
sl@0: 
sl@0: // __________________________________________________________________________
sl@0: // Implementation of CImplementationClassTwelve2
sl@0: 
sl@0: /**
sl@0: Standardised safe construction which leaves nothing the cleanup stack.
sl@0: @param			aInitParams The parameter struct used for initialising this object
sl@0: @return			CImplementationClassTwelve2* The class instance.
sl@0:  */
sl@0: CImplementationClassTwelve2* CImplementationClassTwelve2::NewL(TAny* aInitParams)
sl@0: 	{
sl@0: 	CImplementationClassTwelve2* self=new(ELeave) CImplementationClassTwelve2();  // calls c'tor
sl@0: 	CleanupStack::PushL(self);	// Make the construction safe by using the cleanup stack
sl@0: 	self->ConstructL(aInitParams); // Complete the 'construction'.
sl@0: 	CleanupStack::Pop(self);
sl@0: 	return self;
sl@0: 	}
sl@0: /**
sl@0: Destructor of CImplementationClassTwelve2
sl@0:  */
sl@0: CImplementationClassTwelve2::~CImplementationClassTwelve2()
sl@0: 	{
sl@0: 	delete iInternalDescriptor;
sl@0: 	Dll::FreeTls();
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Default Constructor
sl@0: */
sl@0: CImplementationClassTwelve2::CImplementationClassTwelve2()
sl@0: : CExampleInterface()
sl@0: 	{
sl@0: 	//set the extended interface uid
sl@0: 	iExtendedInterfaceUid.iUid = 0x10009E44;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Completes the safe construction of the CImplementationClassTwelveBasic object
sl@0: @param			aInitParams The parameter struct used for initialising this object
sl@0:  */
sl@0: void CImplementationClassTwelve2::ConstructL(TAny* aInitParams)
sl@0: 	{
sl@0: 	TExampleInterfaceInitParams* params = REINTERPRET_CAST(TExampleInterfaceInitParams*, aInitParams);
sl@0: 	if(params)
sl@0: 		{
sl@0: 		if(params->descriptor)
sl@0: 			iInternalDescriptor = params->descriptor->AllocL();
sl@0: 		}
sl@0: 	User::LeaveIfError(Dll::SetTls(&iTLSInt));
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Overload of the pure interface method.Representative of a method provided on
sl@0: the interface by the interface definer.
sl@0:  */
sl@0: void CImplementationClassTwelve2::DoMethodL()
sl@0: 	{
sl@0: 	// Access TLS to ensure it has been set properly
sl@0: 	ASSERT(Dll::Tls()!=NULL);
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Overload of the pure interface method asynchronous function which
sl@0: an interface definer could specify. 
sl@0: @return			TInt KErrNone for success.
sl@0:  */
sl@0: TInt CImplementationClassTwelve2::FireAndForget()
sl@0: 	{
sl@0: 	return KErrNone;			
sl@0: 	}
sl@0: 
sl@0: // Provide the CActive overloads
sl@0: void CImplementationClassTwelve2::RunL()
sl@0: 	{
sl@0: 	// Do nothing : should never be called
sl@0: 	__ASSERT_DEBUG(EFalse,User::Invariant());
sl@0: 	}
sl@0: 
sl@0: void CImplementationClassTwelve2::DoCancel()
sl@0: 	{
sl@0: 	// Do nothing
sl@0: 	}
sl@0: 
sl@0: TInt CImplementationClassTwelve2::RunError(TInt /*aError*/)
sl@0: 	{
sl@0: 	return KErrNone;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: To verify the object returned by ECOM.
sl@0: @return			TUid (ECOM's Implementation Uid for this class.)
sl@0:  */
sl@0: TUid CImplementationClassTwelve2::ImplId()
sl@0: 	{
sl@0: 	return KImplUid3;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Extended interface method. Called to verify the Extended interface.
sl@0:  */
sl@0: void CImplementationClassTwelve2::DoMethodExtended()
sl@0: 	{
sl@0: 	//check the extended interface uid has been set properly
sl@0: 	ASSERT(iExtendedInterfaceUid.iUid == 0x10009E44);
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Get the extended interface. This method will be called by ECOM, so the method must
sl@0: follow the signature defined by TProxyExtendedInterfaceGetPtrL.This must be a static
sl@0: method since it is used in the proxy table.
sl@0: @param			aObject A pointer to the instantiation interface (CImplementationClassTwelve
sl@0: 				in this case) instance. This will be provided by ECOM. It must be provided
sl@0: 				as a parameter,	as this method is a static method (and must be a static
sl@0: 				method because it is called by the proxy table).
sl@0: @param			aExtendedInterface The extended interface to fetch. Must be a unique UID.
sl@0: @param			aBitFlags Flags used for communication between plugin's and ECOM. Currently
sl@0: 				used to signal if an extended interface requires release.
sl@0: @param			aReleaseObject return parameter, provides ECOM with the object to destroy
sl@0: 				if the interface requires to be released.
sl@0: @return			TAny* a pointer to the fully constructed extended interface object
sl@0: */
sl@0: TAny* CImplementationClassTwelve2::GetExtendedInterfaceL(TAny* aObject,const TUid& aExtendedInterface,TUint32& /*aBitFlags*/,TAny*& /*releaseObject*/)
sl@0: 	{
sl@0: 	TAny* ret = NULL;
sl@0: 	switch (aExtendedInterface.iUid)
sl@0: 		{
sl@0: 		case 0x10009E44:
sl@0: 		    {
sl@0: 	        // No release is required, so do not modify aBitFlags.
sl@0: 		    ret = static_cast<MExampleInterfaceExtended*>(static_cast<CImplementationClassTwelve2*>(aObject));
sl@0: 		    break;
sl@0: 		    }
sl@0: 		default:
sl@0: 			{
sl@0: 			break;    
sl@0: 			}    
sl@0: 		}
sl@0: 	return ret;
sl@0: 	}