--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/telephonyutils/etel3rdpartyapi/ExampleApps/Shared/CISVAPIBase.h	Tue Feb 02 01:41:59 2010 +0200
@@ -0,0 +1,226 @@
+// Copyright (c) 2005-2009 Nokia Corporation and/or its subsidiary(-ies).
+// All rights reserved.
+// This component and the accompanying materials are made available
+// under the terms of "Eclipse Public License v1.0"
+// which accompanies this distribution, and is available
+// at the URL "http://www.eclipse.org/legal/epl-v10.html".
+//
+// Initial Contributors:
+// Nokia Corporation - initial contribution.
+//
+// Contributors:
+//
+// Description:
+// CCISVAPIBase.h
+// 
+//
+
+
+#ifndef __CISVAPIBASE_H__
+#define __CISVAPIBASE_H__
+
+#include <e32base.h>
+#include <etel3rdparty.h>
+
+/**
+Enumeration allocating numbers to different types of classes derived from 
+CISVBase.
+*/
+enum TTelISVExampleType
+	{
+	KNotType = -1,
+	KPhoneId,
+	KSubscriberId,
+	KBatteryInfo,
+	KSignalInfo,
+	KGetIndicator,
+	KLockInfo,
+	KNetworkInfo,
+	KNetworkName,
+	KOperatorName,
+	KCallInfo,
+	KLineStatus,
+	KCallStatus,
+	KFlightModeInfo,
+	KNetworkRegInfo,
+	KAnswerIncomingCall,
+	KDialCall,
+	KDynamicCaps,
+	KHold,
+	KResume,
+	KSwap,
+	KSendDTMF,
+	KHangup,
+	KCallWaitingStatus,
+	KCallForwardingStatus,
+	KCallBarringStatus,
+	KIdentityServiceStatus
+	};
+
+/**
+Enumerations for the potential states of a CMainMenu class.
+*/
+enum TState
+	{
+	EStart,
+	EEnd,
+	EDummyAnswer,
+
+	EGetPhoneId,
+	EGetSubscriberId,
+	EGetCallInfo,
+	EGetBatteryInfo,
+	EGetIndicator,
+	EGetLockInfo,
+	EGetSignalInfo,
+	EGetNetworkInfo,
+	EGetNetworkName,
+	EGetOperatorName,
+
+	EGetFlightModeInfo,
+	EGetNetworkRegStatus,
+
+	EGetLineStatus,
+	EGetCallStatus,
+	EAnswerIncomingCall,
+	EDialCall,
+	EGetDynamicCaps,
+	EHold,
+	EResume,
+	ESwap,
+	ESendDTMF,
+	EHangup,
+
+	ECallForwarding,
+	ECallWaiting,
+	ECallBarring,
+	EIdentityService,
+
+	EWaitingForKeyPress,
+
+	ESetNotifier
+	};
+
+/**
+Base interface providing functionality for a member active object to interact
+with its owning class.
+*/
+class MExecController
+	{
+public:
+	/**
+	End execution of the program, stop the active scheduler making sure all 
+	outstanding requests have been cancelled.
+	*/
+	virtual void Terminate() = 0;
+
+	/**
+	Returns a pointer to the CTelephony Instance so member objects can make
+	calls to the Etel 3rd Party API through the same object.
+	
+	@return CTelephony pointer
+	*/
+	virtual CTelephony* GetTelObj() const = 0;
+
+	/**
+	Returns a pointer to the console instance so
+	member objects can print to the console as required.
+	
+	@return CConsoleBase pointer
+	*/
+	virtual CConsoleBase* GConsole() const = 0;
+
+	};
+
+/**
+Base class providing functionality for objects to make Etel 3rd party function
+calls and interact with their owning class.
+*/
+class CISVAPIBase : public CActive
+	{
+
+public:
+	CISVAPIBase(MExecController* aController,
+			    TTelISVExampleType aExampleType);
+
+	void StartRequestL();
+	void StartRequestL(CTelephony::TCallId aCallId);
+	void StartRequestL(CTelephony::TCallId aCallId1,
+	                   CTelephony::TCallId aCallId2);
+	void StartRequestL(const TDesC& aTones);
+	void RequestNotificationL();
+	void AppTerminate();
+
+	inline void RetrieveTelephonyObject();
+	inline void RetrieveConsole();
+
+	inline TTelISVExampleType GetExampleType() const;
+
+protected:
+	virtual void DoStartRequestL();
+	virtual void DoStartRequestL(CTelephony::TCallId aCallId);
+	virtual void DoStartRequestL(CTelephony::TCallId aCallId1,
+	                             CTelephony::TCallId aCallId2);
+	virtual void DoStartRequestL(const TDesC& aNumber);
+	virtual void DoRequestNotificationL();
+
+protected:
+	/**
+	An instance of the MExecController interface allowing objects derived from
+	this class to make calls back to a class implementing this interface. (In 
+	this case CMainMenu).
+	*/
+	MExecController* iController;
+	/**
+	A CTelephony instance allowing derived classes to make Etel 3rd party
+	calls.
+	*/
+	CTelephony* iTelephony;
+	/**
+	A CConsoleBase instance allowing derived classes to peform console 
+	operations such as printing.
+	*/
+	CConsoleBase* iConsole;
+
+private:
+	/**
+	Specifies the type of the derived class that has extended the functionality
+	of this class.
+	*/
+	const TTelISVExampleType iExampleType;
+
+	};
+
+/**
+Gives the type of the derived class.
+
+@return TTelISVExampleType enumeration value stating the derived type of this
+                           object
+*/
+inline TTelISVExampleType CISVAPIBase::GetExampleType() const
+	{
+	return iExampleType;
+	};
+
+/**
+Retrieves a CTelephony instance from the MExecController implementing class by
+calling the GetTelObj() method of the interface. Sets iTelephony to point to this
+instance. Etel 3rd party calls can be made through this pointer.
+*/
+inline void CISVAPIBase::RetrieveTelephonyObject()
+	{
+	iTelephony = iController->GetTelObj();
+	}
+
+/**
+Retrieves a CConsoleBase instance from the MExecController implementing class by
+calling GConsole() method of the interface. Sets iConsole to point to this
+instance. A console can now be printed to through this pointer.
+*/
+inline void CISVAPIBase::RetrieveConsole()
+	{
+	iConsole = iController->GConsole();
+	}
+
+
+#endif // __CISVAPIBASE_H__