etelagsm.h,v

symbian s60手机上的短信拦截源代码。

		EBarringLocationCachePreferred,
		EBarringLocationNetwork
		};

	virtual TInt GetBarringMode(const TBarringType aType ,TBarringMode& aMode, const TBarringModeLocation aLocation = EBarringLocationCache) const=0;
	virtual void GetBarringMode(TRequestStatus& aReqStatus, const TBarringType aType, TBarringMode& aMode,const TBarringModeLocation aLocation = EBarringLocationCache) const=0;
	virtual void GetBarringModeCancel() const=0;
	virtual TInt SetBarringMode(const TBarringType aType, const TChangeBarringMode& aMode) const=0;
	virtual void SetBarringMode(TRequestStatus& aReqStatus, const TBarringType aType,const TChangeBarringMode& aMode) const=0;
	virtual void SetBarringModeCancel() const=0;
	virtual void BarringModeNotification(TRequestStatus& aReqStatus, TBarringType& aType, TBarringMode& aMode) const=0; 
	virtual void BarringModeNotificationCancel() const=0;

	//
	//	Internal Client/Server struct
	//
	struct TBarringTypeAndLocation
		{
		TBarringModeLocation iLocation;
		TBarringType iType;
		};

	};

//
// Call Forwarding on individual lines
//
class MAdvGsmLineForwarding
	{
public:
	enum TCallForwardingReasonGet
		{
		ECallForwardingGetUnconditional,
		ECallForwardingGetTypeBusy,
		ECallForwardingGetTypeNoReply,
		ECallForwardingGetTypeNotReachable,
		ECallForwardingGetTypeUnknown
		};

	enum TCallForwardingReasonSet
		{
		ECallForwardingSetUnconditional,
		ECallForwardingSetTypeBusy,
		ECallForwardingSetTypeNoReply,
		ECallForwardingSetTypeNotReachable,
		ECallForwardingSetTypeAllCalls,
		ECallForwardingSetTypeAllConditionalCases
		};

	enum TCallForwardingStatus
		{
		ECallForwardingStatusActive,		// CF service is provisioned, registered and active
		ECallForwardingStatusNotActive,		// CF service is provisioned, registered but not active
		ECallForwardingStatusNotRegistered,	// CF service is provisioned but not registered
		ECallForwardingStatusNotProvisioned,// CF serivce is not provisioned
		ECallForwardingStatusUnavailable,	// CF service is not available in serving PLMN
		ECallForwardingStatusUnknown		// CF service status can not be determined.
		};									

	enum TCallForwardingAction
		{
		ECallForwardingInterrogation, 
		ECallForwardingRegistration,
		ECallForwardingActivation,
		ECallForwardingDeactivation,
		ECallForwardingErasure
		};

	enum TCallForwardingActive
		{
		ECallForwardingUnconditionalActive,
		ECallForwardingConditionalActive
		};

	enum TForwardingInfoLocation
		{
		EForwardingLocationCache,
		EForwardingLocationCachePreferred,
		EForwardingLocationNetwork
		};
			   
	enum TCallForwardingSetting
		{
		ECallForwardingActivate, 
		ECallForwardingRegister,
		ECallForwardingDeactivate,
		ECallForwardingErase
		};

	struct TCallForwardingChange
		{
		TCallForwardingSetting iSetting;
		TGsmTelNumber iNumber;
		TInt iTimeout;						// only applicable to CFNRy (= -1 otherwise)
		};

	struct TCallForwardingInfo
		{
		TCallForwardingStatus iStatus;
		TCallForwardingAction iAction;
		TGsmTelNumber iNumber;
		TInt iTimeout;						// only applicable to CFNRy (= -1 otherwise)
		};

	virtual TInt GetCallForwardingInfo(const TCallForwardingReasonGet aReason, TCallForwardingInfo& aInfo,const TForwardingInfoLocation aLocation = EForwardingLocationCache) const=0;
	virtual void GetCallForwardingInfo(TRequestStatus& aReqStatus,const TCallForwardingReasonGet aReason, TCallForwardingInfo& aInfo,const TForwardingInfoLocation aLocation = EForwardingLocationCache) const=0;
	virtual void GetCallForwardingInfoCancel() const=0;
	virtual TInt SetCallForwardingStatus(const TCallForwardingReasonSet aReason,const TCallForwardingChange& aInfo) const=0;
	virtual void SetCallForwardingStatus(TRequestStatus& aReqStatus, const TCallForwardingReasonSet aReason,const TCallForwardingChange& aInfo) const=0;
	virtual void SetCallForwardingStatusCancel() const=0;

	virtual void CallForwardingStatusNotification(TRequestStatus& aReqStatus, TCallForwardingReasonGet& aReason, TCallForwardingInfo& aInfo) const=0;
	virtual void CallForwardingStatusNotificationCancel() const=0;

	virtual void CallForwardingActiveNotification(TRequestStatus& aReqStatus, TCallForwardingActive& aActiveService) const=0;
	virtual void CallForwardingActiveNotificationCancel() const=0;

	//
	//	Internal Client/Server structs
	//
	struct TForwardingReasonAndLocation
		{
		TCallForwardingReasonGet iReason;
		TForwardingInfoLocation iLocation;
		};

	struct TForwardingReasonAndAction
		{
		TCallForwardingReasonGet iReason;
		TCallForwardingAction iAction;
		};

	};


//
// Call Waiting on individual lines
//

class MAdvGsmLineCallWaitingMode
	{
public:
	enum TCallWaitingMode
		{
		ECallWaitingModeActive,			// CW service is provisioned and active
		ECallWaitingModeNotActive,		// CW service is provisioned but not active
		ECallWaitingModeNotProvisioned, // CW service is not provisioned
		ECallWaitingModeUnavailable,	// CW service is not available in serving PLMN
		ECallWaitingModeUnknown			// CW service status can not be determined
		};								// It could be one of the following :-
										// 1. Not provisioned
										// 2. Provisioned but not active

	enum TCallWaitingSetting
		{
		ECallWaitingActivate,
		ECallWaitingDeactivate
		};

	enum TWaitingModeLocation
		{
		EWaitingLocationCache,
		EWaitingLocationCachePreferred,
		EWaitingLocationNetwork
		};

	virtual TInt GetCallWaitingMode(TCallWaitingMode& aMode,const TWaitingModeLocation aLocation = EWaitingLocationCache) const=0;
	virtual void GetCallWaitingMode(TRequestStatus& aReqStatus,TCallWaitingMode& aMode,const TWaitingModeLocation aLocation = EWaitingLocationCache) const=0;
	virtual void GetCallWaitingModeCancel() const=0;
	virtual TInt SetCallWaitingMode(const TCallWaitingSetting aSetting) const=0;
	virtual void SetCallWaitingMode(TRequestStatus& aReqStatus, const TCallWaitingSetting aSetting) const=0;
	virtual void SetCallWaitingModeCancel() const=0;
	virtual void NotifyCallWaitingModeChange(TRequestStatus& aReqStatus, TCallWaitingMode& aMode) const=0;
	virtual void NotifyCallWaitingModeChangeCancel() const=0;

	};

//
//
// RAdvGsmLine
//
//
class CAdvLinePtrHolder;
class RAdvGsmLine : public RLine, public MAdvGsmLineStatusAndCallInfo, public MAdvGsmLineBarring,
					public MAdvGsmLineForwarding, public MAdvGsmLineCallWaitingMode,
					public MAdvGsmLineAutoRetry
	{
public:
	IMPORT_C RAdvGsmLine();

//
//	General notification information
//
	IMPORT_C void AutoRetry(TRequestStatus& aReqStatus, const TGsmTelNumber& aTelNumber, TName& aNewCallName) const;
	IMPORT_C void AutoRetryCancel() const;

	IMPORT_C TInt GetAdvGsmLineStatus(TAdvGsmLineStatus& aReqStatus) const;
	IMPORT_C void NotifyAdvGsmLineStatusChange(TRequestStatus& aReqStatus, TAdvGsmLineStatus& aInfo) const;
	IMPORT_C void NotifyAdvGsmLineStatusChangeCancel() const;
	IMPORT_C TInt GetAdvGsmCallInfo(const TInt aIndex, TAdvGsmCallInfo& aCallInfo) const;
	IMPORT_C TInt GetAdvGsmLineCaps(TCaps& aAdvGsmLineCaps) const;

	IMPORT_C TInt GetBarringMode(const TBarringType aType ,TBarringMode& aMode, const TBarringModeLocation aLocation = EBarringLocationCache) const;
	IMPORT_C void GetBarringMode(TRequestStatus& aReqStatus, const TBarringType aType, TBarringMode& aMode,const TBarringModeLocation aLocation = EBarringLocationCache) const;
	IMPORT_C void GetBarringModeCancel() const;
	IMPORT_C TInt SetBarringMode(const TBarringType aType,const TChangeBarringMode& aMode) const;
	IMPORT_C void SetBarringMode(TRequestStatus& aReqStatus, const TBarringType aType,const TChangeBarringMode& aMode) const;
	IMPORT_C void SetBarringModeCancel() const;
	IMPORT_C void BarringModeNotification(TRequestStatus& aReqStatus, TBarringType& aType, TBarringMode& aMode) const;
	IMPORT_C void BarringModeNotificationCancel() const;

	IMPORT_C TInt GetCallForwardingInfo(const TCallForwardingReasonGet aReason, TCallForwardingInfo& aInfo,const TForwardingInfoLocation aLocation = EForwardingLocationCache) const;
	IMPORT_C void GetCallForwardingInfo(TRequestStatus& aReqStatus,const TCallForwardingReasonGet aReason, TCallForwardingInfo& aInfo,const TForwardingInfoLocation aLocation = EForwardingLocationCache) const;
	IMPORT_C void GetCallForwardingInfoCancel() const;
	IMPORT_C TInt SetCallForwardingStatus(const TCallForwardingReasonSet aReason,const TCallForwardingChange& aInfo) const;
	IMPORT_C void SetCallForwardingStatus(TRequestStatus& aReqStatus, const TCallForwardingReasonSet aReason,const TCallForwardingChange& aInfo) const;
	IMPORT_C void SetCallForwardingStatusCancel() const;
	IMPORT_C void CallForwardingStatusNotification(TRequestStatus& aReqStatus, TCallForwardingReasonGet& aReason,TCallForwardingInfo& aInfo) const;
	IMPORT_C void CallForwardingStatusNotificationCancel() const;
	IMPORT_C void CallForwardingActiveNotification(TRequestStatus& aReqStatus, TCallForwardingActive& aActiveService) const;
	IMPORT_C void CallForwardingActiveNotificationCancel() const;

	IMPORT_C TInt GetCallWaitingMode(TCallWaitingMode& aMode,const TWaitingModeLocation aLocation = EWaitingLocationCache) const;
	IMPORT_C void GetCallWaitingMode(TRequestStatus& aReqStatus,TCallWaitingMode& aMode,const TWaitingModeLocation aLocation = EWaitingLocationCache) const;
	IMPORT_C void GetCallWaitingModeCancel() const;
	IMPORT_C TInt SetCallWaitingMode(const TCallWaitingSetting aSetting) const;
	IMPORT_C void SetCallWaitingMode(TRequestStatus& aReqStatus, const TCallWaitingSetting aSetting) const;
	IMPORT_C void SetCallWaitingModeCancel() const;
	IMPORT_C void NotifyCallWaitingModeChange(TRequestStatus& aReqStatus, TCallWaitingMode& aMode) const;
	IMPORT_C void NotifyCallWaitingModeChangeCancel() const;	

private:
	CAdvLinePtrHolder* iAdvPtrHolder;
protected:
	IMPORT_C virtual void ConstructL();
	IMPORT_C virtual void Destruct();
	};

//
// Calling/Called Party identification Presentation and Restriction
//
class MAdvGsmPhoneLineIdentity
	{
public:
//
// CLIP
//
	enum TClipMode
		{
		EClipModeActive,
		EClipModeNotProvisioned,
		EClipModeUnknown
		};

	virtual TInt GetClipMode(TClipMode& aMode) const=0;
	virtual void GetClipMode(TRequestStatus& aReqStatus, TClipMode& aMode) const=0;
	virtual void GetClipModeCancel() const=0;
	virtual void ClipModeNotification(TRequestStatus& aReqStatus, TClipMode& aMode) const=0;
	virtual void ClipModeNotificationCancel() const=0;
//
// CLIR
//
	enum TClirMode
		{
		EClirModePermanentRestricted,
		EClirModeTemporaryDefaultRestricted,
		EClirModeTemporaryDefaultAllowed,
		EClirModeNotProvisioned,
		EClirModeUnknown
		};

	virtual TInt GetClirMode(TClirMode& aMode) const=0;
	virtual void GetClirMode(TRequestStatus& aReqStatus, TClirMode& aMode) const=0;
	virtual void GetClirModeCancel() const=0;
	virtual void ClirModeNotification(TRequestStatus& aReqStatus, TClirMode& aMode) const=0;
	virtual void ClirModeNotificationCancel() const=0;
//
// COLP
//
	enum TColpMode
		{
		EColpModeActive,
		EColpModeNotProvisioned,
		EColpModeUnknown
		};

	virtual TInt GetColpMode(TColpMode& aMode) const=0;
	virtual void GetColpMode(TRequestStatus& aReqStatus, TColpMode& aMode) const=0;
	virtual void GetColpModeCancel() const=0;
	virtual void ColpModeNotification(TRequestStatus& aReqStatus, TColpMode& aMode) const=0;
	virtual void ColpModeNotificationCancel() const=0;

//
// COLR
//
	enum TColrMode
		{
		EColrModeActive,
		EColrModeNotProvisioned,
		EColrModeUnknown
		};

	virtual TInt GetColrMode(TColrMode& aMode) const=0;
	virtual void GetColrMode(TRequestStatus& aReqStatus, TColrMode& aMode) const=0;
	virtual void GetColrModeCancel() const=0;
	virtual void ColrModeNotification(TRequestStatus& aReqStatus, TColrMode& aMode) const=0;
	virtual void ColrModeNotificationCancel() const=0;
	};

//
// Own Number Information
//
class MAdvGsmPhoneOwnNumber
	{
public:
	enum
		{
		KSizeOfOwnNumberText=100
		};

	enum TInfoTransferCap
		{
		EITCVoice,
		EITCAuxVoice,
		EITCUDI,
		EITCThreePointOnekHz,
		EITCFax
		};

	enum TBearerService
		{
		EServiceAsynchronousModem,
		EServiceSynchronousModem,
		EServicePADAccess,
		EServicePacketAccess
		};


	enum TBearerCE
		{
		EBearerCETransparent,
		EBearerCENonTransparent
		};

	struct TOwnNumberEntry
		{
		TBuf<KSizeOfOwnNumberText> iText;
		TGsmTelNumber iTelNumber;
		TInfoTransferCap iInfoTransferCap;
		TUint iBearerSpeed;
		TBearerService iBearerService;
		TBearerCE iBearerCE;
		};

	struct TOwnNumberInfo
		{
		TUint iNumOfEntries;
		TUint iMaxNumOfEntries;
		TUint iMaxTelNumberLen;
		TUint iMaxTextLength;
		};

	virtual TInt GetOwnNumberInfo(TOwnNumberInfo& aOwnNumberInfo) const=0;
	virtual void GetOwnNumberInfo(TRequestStatus& aReqStatus, TOwnNumberInfo& aOwnNumberInfo) const=0;
	virtual void GetOwnNumberInfoCancel() const=0;

	virtual TInt GetOwnNumberEntry(const TInt aIndex, TOwnNumberEntry& aEntry) const=0;
	virtual void GetOwnNumberEntry(TRequestStatus& aReqStatus, const TInt aIndex, TOwnNumberEntry& aEntry) const=0;
	virtual void GetOwnNumberEntryCancel() const=0;
	
	virtual TInt SetOwnNumberEntry(const TInt aIndex, const TOwnNumberEntry& aEntry) const=0;
	virtual void SetOwnNumberEntry(TRequestStatus& aReqStatus, const TInt aIndex, const TOwnNumberEntry& aEntry) const=0;
	virtual void SetOwnNumberEntryCancel() const=0;

	virtual void NotifyOwnNumberEntryChanged(TRequestStatus& aReqStatus, TInt& aIndex) const=0;
	virtual void NotifyOwnNumberEntryChangedCancel() const=0;
	};

//
// Network Identity & Time Zone (NITZ)
// 

class MAdvGsmPhoneNitz
	{
public:
	//
	// NITZ information structure
	//
	struct TNITZInfo
		{
		TBool iTimeValid;
		TDateTime iDateTime;
		TBool iTimeZoneValid;
		TInt iTimeZone;
		TBool iNetworkInfoValid;
		RBasicGsmPhone::TNetworkInfo iNetworkInfo;
		};
	
	// Get current NITZ if available - return KErrNotFound if none exists
	virtual TInt GetCurrentNITZInfo(TNITZInfo& aNITZInfo) const=0;	

	// Notification of any new NITZ info received from the network
	virtual void NotifyNITZInfoChange(TRequestStatus& aReqStatus, TNITZInfo& aNITZInfo) const=0;
	virtual void NotifyNITZInfoChangeCancel() const=0;
	};

//
// Phone-level advanced network information
//

class CGsmNetworkList;
class MAdvGsmPhoneNetwork
	{
public:

	virtual CGsmNetworkList* RetrievePreferredNetworksLC()=0;
	virtual TInt StorePreferredNetworksL(CGsmNetworkList* aNetworkList) const=0;