/*

* Copyright (c) 2002-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:  MNssGetTagClient provides the public callback interfaces for clients 

*               that want to retrieve tags from the VAS Db. The client must inherit 

*               and override the GetTagCompleted() and GetTagFailed() methods to 

*               handle VAS Db responses for retrieving tag(s).

*

*/

#ifndef MNSSGETTAGCLIENT_H

#define MNSSGETTAGCLIENT_H

// includes 

#include <e32std.h>

#include <e32base.h>

// forward declarations

class MNssTag;

//typedef 

typedef CArrayPtrFlat<MNssTag> MNssTagListArray;

// CLASS DECLARATIONS

/**

*  MNssGetTagClient defines the call back methods used by VAS DB

*  when replying to an asynchronous GetTag() request.

*  @lib NssVASApi.lib

*  @since 2.0

*/

class MNssGetTagClient

{

public:

#ifdef __SIND_RD_BREAK_PHONEBOOK_COMPATIBILITY

   /**

   * Callback to indicate GetTag successed.

   * client has to delete the tag list

   * @since 3.2

   * @param aTagList 

   */

   virtual void GetTagListCompleted( MNssTagListArray* aTagList,

                                     TInt aErrorCode ) = 0;

#else

   enum TNssGetTagClientFailCode

   {

	  EVASDBItemNotFound = 1, 

	  EVASDBNoMemory,

	  EVASDBDiskFull,

	  EVASDBFailure

   };

   /**

   * Callback to indicate GetTag successed.

   * client has to delete the tag list

   * @since 2.0

   * @param aTagList 

   */

   virtual void GetTagListCompleted( MNssTagListArray* /*aTagList*/,

                                     TInt /*aErrorCode*/ ) {};   

   /**

   * Callback to indicate GetTag successed.

   * client has to delete the tag list

   * @since 2.0

   * @param aTagList 

   */

   virtual void GetTagListCompleted( MNssTagListArray* /*aTagList*/ ) {};

   /**

   * Callback to indicate GetTag failed.

   * @since 2.0

   * @param aFailCode - The reason GetTag failed

   */ 

   virtual void GetTagFailed( TNssGetTagClientFailCode /*aFailCode*/ ) {};

#endif // __SIND_RD_BREAK_PHONEBOOK_COMPATIBILITY   

};

#endif