/*
* Copyright (c) 2006, 2007 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:  This class defines the dps script receiving function. 
*
*/


#ifndef DPSSCRIPTRECEIVER_H
#define DPSSCRIPTRECEIVER_H

#include <e32base.h>

class CDpsEngine;
class CDpsStateMachine;

/**
*   This class is an active object. It listens on the ptp server
*   object receiving notification.
*/
NONSHARABLE_CLASS(CDpsScriptReceiver) : public CActive
    {	
    public:
       /**
        *   Two phase constructor
        *   
        *   @param aOperator the pointer to the dps state machine
        *   @return a CDpsScriptReceiver instance
        */
        static CDpsScriptReceiver* NewL(CDpsStateMachine* aOperator);
								       
        /**
        *   Destructor
        */								       
        ~CDpsScriptReceiver();
		
        /**
        *   Issues the request of receiving.
        */
        void WaitForReceive();
		
        /**
        *   @return the file name of the object been received
        */
        const TDesC& FileNameAndPath();
			
    private: // Functions derived from CActive.
        /**
        *   @see CActive
        */
    	void RunL();
    	
    	/**
    	*   @see CActive
    	*/
        void DoCancel();
	    
        /**
        *   @see CActive
        */
        TInt RunError(TInt aError);
	    
    private:
        
        /**
        *   Default constructor
        *   
        *   @param aOperator the pointer to the dps state machine
        */
        CDpsScriptReceiver(CDpsStateMachine* aOperator);    
	    
        /**
        *   Gets the file name from the full filename
        *   @param aFileName the full filename including file path
        *   @return KErrNone if Ok, otherwise the system wide error
        */
        TInt GetFileName(TDes& aFileName);
		
    private:
        
        // not owned by this class
        CDpsStateMachine* iOperator;   
        // file name of received script file 
        TFileName iFileNameAndPath;
    };
						
#endif