/*

* 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:

*

*/

#ifndef CCALREMOTEATTACHMENTAPI_H

#define CCALREMOTEATTACHMENTAPI_H

#include <e32base.h>

#include <bamdesca.h>

class MCalRemoteAttachment;

class MCalRemoteAttachmentInfo;

class MCalRemoteAttachmentOperation;

class MCalRemoteAttachmentOperationObserver;

/**

 * CCalRemoteAttachmentApi defines calendar attachment download operations.

 */

class CCalRemoteAttachmentApi : public CBase

    {

public: // Construction and destruction

    /**

	 * Creates and initializes new CCalRemoteAttachmentApi object. Ownership 

	 * is transferred to caller. 

	 * @param aUri

	 */

	static CCalRemoteAttachmentApi* NewL( const TDesC8& aUri );

	/**

	 * Destructor

	 */

	virtual ~CCalRemoteAttachmentApi();

public: // Interface

	/**

	 * Fetches attachment information.

	 * @param aAttachmentInfo Reference to attachment info array

	 * @param aAttachmentUrlArray List of attachment URIs which information is wanted 

	 */

	virtual void AttachmentInfo(

	        MCalRemoteAttachmentInfo& aAttachmentInfo,

	        MDesCArray& aAttachmentUrlArray ) const = 0;

	/**

	 * Downloads attachment. Ownership of created operation is transferred

	 * to caller. Created operations are stored to <aOperations> array.

	 * 

	 * @param aAttachments Attachments to be downloaded index

	 * @param aOperations Operation array.

	 * @param aObserver Reference to attachment observer

	 */

	virtual void DownloadAttachmentsL(

	        const RPointerArray<MCalRemoteAttachment>& aAttachments,

	        RPointerArray<MCalRemoteAttachmentOperation>& aOperations,

	        MCalRemoteAttachmentOperationObserver& aObserver ) = 0;

private:

        /** iDtor_ID_Key Instance identifier key. When instance of an

         *               implementation is created by ECOM framework, the

         *               framework will assign UID for it. The UID is used in

         *               destructor to notify framework that this instance is

         *               being destroyed and resources can be released.

         */

        TUid iDtor_ID_Key;	

	};

#include <ccalremoteattachmentapi.inl>

#endif // CCALREMOTEATTACHMENTAPI_H

// EOF