1 /*

     2 * Copyright (c) 2007 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:  

    15  *

    16 */

    17 

    18 

    19 #ifndef C_ACTIONHANDLERSERVICE_H

    20 #define C_ACTIONHANDLERSERVICE_H

    21 

    22 /**

    23  *  Class implements Action Handler Service Provider

    24  *

    25  *  Action Handler itself is a component which enables

    26  *  to execute different kind of actions.

    27  *

    28  *  @since S60 v3.2

    29  */

    30 class CActionHandlerService : public CLiwServiceIfBase

    31     {

    32 public:

    33 

    34     static CActionHandlerService* NewL();

    35 

    36     ~CActionHandlerService();

    37 

    38     // from base class CLiwServiceIfBase

    39 

    40     /**

    41      * From CLiwServiceIfBase.

    42      * Called by the LIW framework to initialise necessary information 

    43      * from the Service Handler. This method is called when the consumer makes

    44      * the attach operation.

    45      *

    46      * @since S60 v3.2

    47      * @param aFrameworkCallback Framework provided callback

    48      * @param aInterest List of criteria items which invoked the provider.

    49      */

    50     void InitialiseL( MLiwNotifyCallback& aFrameworkCallback,

    51         const RCriteriaArray& aInterest );

    52 

    53     /**

    54      * Executes generic service commands included in criteria.

    55      *

    56      * @param aCmdId Command to be executed.

    57      * @param aInParamList Input parameters, can be an empty list.

    58      * @param aOutParamList Output parameters, can be an empty list.

    59      * @param aCmdOptions Options for the command

    60      * @param aCallback Callback for asynchronous command handling, 

    61      * @leave KErrArgument Callback is missing when required.

    62      * @leave KErrNotSupported No provider supports service.

    63      */

    64     virtual void HandleServiceCmdL( const TInt& aCmdId,

    65         const CLiwGenericParamList& aInParamList,

    66         CLiwGenericParamList& aOutParamList, TUint aCmdOptions = 0,

    67         const MLiwNotifyCallback* aCallback = NULL );

    68 

    69 private:

    70 

    71     CActionHandlerService();

    72 

    73     TInt32 ErrCodeConversion( TInt code );

    74 

    75 private:

    76     // data

    77 

    78 

    79     };

    80 

    81 #endif // C_ACTIONHANDLERSERVICE_H