1 /*

     2 * Copyright (c) 2006 Nokia Corporation and/or its subsidiary(-ies).

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  Harvester Utility observer

    15 *

    16 */

    17 

    18 

    19 #ifndef MMPXHARVESTERUTILITYOBSERVER_H

    20 #define MMPXHARVESTERUTILITYOBSERVER_H

    21 

    22 /**

    23  *  Observer to the harvester utility, for async calls

    24  *

    25  *  @lib mpxharvesterutility.lib

    26  */

    27 NONSHARABLE_CLASS(MMPXHarvesterUtilityObserver)

    28     {

    29 

    30 public:

    31 

    32     /**

    33      * Callback from method MMPXHarvesterUtility::ExportPlaylistL().

    34      * Handles completion of playlist export. observer assumed

    35      * ownership of aMedia.

    36      *

    37      * @since S60 3.0

    38      * @param aMedia media object containing the playlist

    39      *        aMedia is NULL if aErr != KErrNone

    40      * @param aErr error code for the operation

    41      */

    42     virtual void HandlePlaylistExportCompletedL( CMPXMedia* aMedia, TInt aErr ) = 0;

    43 

    44     /**

    45      * Callback from method MMPXHarvesterUtility::ImportPlaylist().

    46      * Handles completion of playlist import.

    47      *

    48      * @since S60 3.0

    49      * @param aMedia media parsed from the playlist file, observer

    50      *        assumes ownership of this media

    51      *        aMedia is NULL if the aErr != KErrNone

    52      * @param aErr  error code for the operation

    53      */

    54     virtual void HandlePlaylistImportCompletedL( CMPXMedia* aMedia,

    55                                                  TInt aErr ) = 0;

    56 

    57     /**

    58      * Callback from method MMPXHarvesterUtility:: AddFileL().

    59      * Handle asynchronous file addition by file name, observer

    60      * assumes ownership of aMedia.

    61      *

    62      * @since S60 3.0

    63      * @param aMedia media object containing the media details of the file

    64      *        aMedia is NULL if aErr != KErrNone

    65      * @param aErr error code for the operation

    66      */

    67     virtual void HandleFileAddCompletedL( CMPXMedia* aMedia,

    68                                           TInt aErr ) = 0;

    69 

    70     /**

    71      * Callback from method MMPXHarvesterUtility::DeleteFilesL().

    72      * Handle file delete completion.

    73      *

    74      * @since S60 3.0

    75      * @param aErr error code for the operation

    76      */

    77     virtual void HandleDeleteCompletedL( TInt aErr ) = 0;

    78 

    79     /**

    80      * Callback from method MMPXHarvesterUtility::ImportFileL().

    81      * Handle file import completion.

    82      *

    83      * @since S60 3.0

    84      * @param aMedia media object containing the media details of the file

    85      *        aMedia is NULL if aErr != KErrNone

    86      * @param aErr error code for the operation

    87      */

    88     virtual void HandleFileImportCompletedL( CMPXMedia* aMedia, TInt aErr  ) = 0;

    89 

    90     /**

    91      * Callback from method MMPXHarvesterUtility::GetMediaForFileL().

    92      * Handle asynchronous media creation by file name, observer

    93      * assumes ownership of aMedia.

    94      *

    95      * @since S60 3.0

    96      * @param aMedia media object containing the media details of the file

    97      *        aMedia is NULL if aErr != KErrNone

    98      * @param aErr error code for the operation

    99      */

   100     virtual void HandleFileGetMediaCompletedL( CMPXMedia* aMedia, TInt aErr ) = 0;

   101 

   102     };

   103 

   104 

   105 #endif // MMPXHARVESTERUTILITYOBSERVER_H