mmappfw_plat/mpx_collection_common_definition_api/inc/mpxcollectionenginecommonobserver.h
/*
* Copyright (c) 2006 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: Collection engine common observer
*
*/
#ifndef MMPXCOLLECTIONENGINECOMMONOBSERVER_H
#define MMPXCOLLECTIONENGINECOMMONOBSERVER_H
#include <badesca.h>
class CMPXMedia;
#include <mpxcommand.h>
/**
* Interface for receiving data asynchronously
*/
NONSHARABLE_CLASS(MMPXCollectionEngineCommonObserver)
{
public:
/**
* Handle media.
*
* @since S60 3.2.3
* @param aMedia media object, NULL if error
* @param aError error code
*/
virtual void HandleMedia(CMPXMedia* aMedia, TInt aError) = 0;
/**
* Handle completion of a asynchronous command.
*
* @since S60 3.2.3
* @param aCommandResult result of the command, NULL if error
* @param aError error code
*/
virtual void HandleCommandComplete(CMPXCommand* aCommandResult,
TInt aError) = 0;
/**
* Handles removing a collection path.
* Use case is if an item is removed by a collecton path, we need to
* know which files were actually removed to delete from FS.
*
* @since S60 3.2.3
* @param aUriArray NULL if the plugin does not use concept of URI
* else, contains the file path to delete a file
* @param aError error code
*
*/
virtual void HandleRemove(const CDesCArray& aUriArray, TInt aError) = 0;
/**
* Handles FindAllL results.
* After find results are passed to the engine, the media object
* needs to be picked up by the client.
*
* @since S60 3.2.3
* @param aMedia media item(s)
* @param aError error for the operation, or size of the buffer to return
*/
virtual void HandleFindAll(CMPXMedia* aMedia, TInt aError) = 0;
};
#endif // MMPXCOLLECTIONENGINECOMMONOBSERVER_H