// Copyright (c) 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:

// cmtpdeltadatamgr.h

// 

//

/**

 @file

 @publishedPartner

 @released

*/

#ifndef  __INC_RPTP_H

#define  __INC_RPTP_H

#include <e32base.h>

const TInt KFileExtLength = 8;

enum TDpsPrinterState

    {

    EPrinterNotAvailable,

    EPrinterAvailable

    };       

/**

*  RPtp class is used to create a PTP Server session and a connection to the

*  selected transport medium.

*/

NONSHARABLE_CLASS(RPtp) : public RSessionBase

    {

public:

    IMPORT_C RPtp();

    /**

    * Creates new session to PTP Server. This also register the observer

    * to the ptp server. This should be only used by the client

    */  

    IMPORT_C TInt Connect();

    /**

    * Creates connection to the server and initializes the ptp stack based on

    * specified transport medium.

    * @return KErrNone if success or system error if failed.

    */

    IMPORT_C TInt CreatePtpStack( const TUid aTransport );

    /**

    * Performs DPS discovery.

    * @param aStatus the result of the Dps discovery, either EAvailable or

    *   NotAvailable from TDpsPrinterState enum

    */

    IMPORT_C void IsDpsPrinter(TRequestStatus& aStatus);

    /**

    * Cancels previously issued Asynch request IsDpsPrinter

    */

    IMPORT_C void CancelIsDpsPrinter();

    /**

    * Client sends object and get informed when the object is received by

    * the host. This method is intended for sending DPS files only.

    * @param aNameAndPath, the name and full path of the file.

    * @param aStatus, Asynchronous completion word for the operation.

    * @param aTimeout whether the client needs the reply for this request. If

    *   it needs the timeout will be true, which means if timout happened, 

    *   the reply is KErrTimedout. 

    * @param aSize  size of the object to be sent. Not used. @deprecated 5.2

    * @param aAdd  Not used. @deprecated 5.2

    */

    IMPORT_C void SendObject(const TDesC& aNameAndPath, 

                             TRequestStatus& aStatus, TBool aTimeout,

                             TInt aSize=0, TBool aAdd = EFalse);

    /**

    * Cancel object sending request.

    */

    IMPORT_C void CancelSendObject();

    /**

    * Registers the certain DPS files arrival (from the host) notification. 

    * Note that the received file is deleted when next call on this API is made.

    * @param aFileExtension.  file extension

    * @param aNameAndPath  name and path of the file.

    * @param aDelete @deprecated. The recveived file is always deleted when next

    *    call to any method on this API is made.

    * @param aStatus, Asynchronous completion word for the operation.

    * @return None.

    */

    IMPORT_C void ObjectReceivedNotify(const TDesC& aFileExtension,

                                       TDes& aNameAndPath, 

                                       TRequestStatus& aStatus,

                                       TBool aDelete = EFalse);

    /**

    * Gets the object handle (whether the object exists).

    * The client may use this function to delete certain file 

    * (mainly for dps now)  

    * @param aNameAndPath, A name and full path of the file.

    * @param aHandle , 32bit handle of the object

    * @param aAdd if ETrue, this object is added to the list if not found.

    * @return KErrNone if object is found or KErrNotFound if not.

    */

    IMPORT_C TInt GetObjectHandleByName(const TDesC& aNameAndPath, 

                                        TUint32& aHandle, 

                                        TBool aAdd = EFalse);

    /**

    * Gets the file name.

    * @param aNameAndPath, A name and full path of the file.

    * @param aHandle , 32bit handle of the objcet

    * @return KErrNone if successfull or system error if failed

    */

    IMPORT_C TInt GetNameByObjectHandle(TDes& aNameAndPath, 

                                        const TUint32 aHandle );

    /**

    * Cancel Object received notification 

    */

    IMPORT_C void CancelObjectReceivedNotify();

    /**

    * Closes the connection to PTP server.

    */

    IMPORT_C void DestroyPtpStatck();

    /**

    * Returns name and path of folder. Note: while this still returns a valid folder name,

    * that folder is no more used for anything.

    * @return Folder Name and Path

    */

    IMPORT_C const TDesC& PtpFolder();

    /**

    */

    IMPORT_C void Close();    

private:

    TInt DoConnect();        

private:

    TBuf<KFileExtLength> iExt;

    TFileName iFile;

    TBool iConnected;

    };

#endif