callcontinuity/vcc/inc/tvccstatefailing.h
changeset 0 a4daefaec16c
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/callcontinuity/vcc/inc/tvccstatefailing.h	Mon Jan 18 20:12:36 2010 +0200
@@ -0,0 +1,132 @@
+/*
+* Copyright (c) 2008 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:   Function definitions for VCC Failing State
+*
+*/
+
+
+
+#ifndef TVCCSTATEFAILING_H
+#define TVCCSTATEFAILING_H
+
+//  INCLUDES
+#include <e32base.h>
+#include <e32cmn.h> // HBufC
+
+#include "tvccstate.h"
+
+/**  Failing state name */
+const TUint KVccStateFailing = 3;
+
+//forward declarations
+class CVccPerformer;
+
+/**
+* Failing state. Can be accessed from calling state if some problem
+* occurs.
+*
+* init -> calling -> releasing -> init
+* 
+*  @lib vccperformer.dll
+*  @since S60 3.2
+*/
+class TVccStateFailing: public TVccState
+    {
+          
+public:
+	/**
+	* c'tor
+	*/
+	TVccStateFailing();
+	
+    /**
+    * Links the state i.e. provides transition points.
+    * @param aReleasing a realising state
+    */
+    void LinkState( TVccState& aInit );
+	
+// From base class TVccState
+    
+    /**
+     * @see TVccState::Name()
+     */
+	TUint Name() const;
+	
+    /**
+     * @see TVccState::CallStateChanged()
+     */
+	void CallStateChanged( CVccPerformer& aContext, 
+	                    const MCCPCallObserver::TCCPCallState aState,
+	                    MCCPCall* aCall );
+	
+    /**
+     * @see TVccState::CallStateChangedWithInband()
+     */
+	void CallStateChangedWithInband(CVccPerformer& aContext, 
+	            const MCCPCallObserver::TCCPCallState aState,
+	            MCCPCall* aCall );
+	
+    /**
+     * @see TVccState::CallEventOccurred()
+     */
+	void CallEventOccurred( CVccPerformer& aContext, 
+	            const MCCPCallObserver::TCCPCallEvent aEvent,
+	            MCCPCall* aCall );
+	    
+    /**
+     * @see TVccState::ErrorOccurred()
+     */
+    void ErrorOccurred( CVccPerformer& aContext, 
+                        const TCCPError aError,
+                        MCCPCall* aCall );	
+	
+private:
+    //no copying
+    TVccStateFailing( const TVccStateFailing& );
+    TVccStateFailing operator = ( const TVccStateFailing& );
+    
+    /**
+    * If new leg is cleared, set the state again to init.
+    * param aContext Reference to Performer object
+    */
+    void CheckAndMoveToInit( CVccPerformer& aContext,  MCCPCall* aCall,
+                                        const MCCPCallObserver::TCCPCallState aState );
+    
+    /**
+    * Inspects the state changed for possible remote disconnect and other
+    * failing hand-over cases.
+    * @param aContext a state context
+    * @param aState a current state value
+    * @param aCall the call leg emetting the event
+    * @param aCallee the object instance calling the callback
+    * @param aCallback a function to call in case event must be emitted and not suppressed.
+    */  
+    void InspectChangedStates( CVccPerformer& aContext, 
+                               const MCCPCallObserver::TCCPCallState aState,
+                               MCCPCall* aCall,
+                               MCCPCallObserver* aCallee,
+                               void( MCCPCallObserver::*aCallback)(const MCCPCallObserver::TCCPCallState, MCCPCall*));
+    
+private: // data
+    /**
+     * Reference to Init state
+     * Not own.
+     */
+	TVccState* iInit;
+	
+	};
+
+#endif      // TVCCSTATEFAILING_H
+
+// End of File