1 /*

     2 * Copyright (c) 2005-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:  Header file for the UpnpAiwOpenExternalService.

    15 *

    16 */

    17 

    18 

    19 #ifndef _UPNP_AIW_OPEN_EXTERNAL_SERVICE_H

    20 #define _UPNP_AIW_OPEN_EXTERNAL_SERVICE_H

    21 

    22 //  INCLUDES

    23 #include <AiwServiceIfBase.h>

    24 

    25 // FUNCTION PROTOTYPES

    26 class CUPnPAiwEngine;

    27 

    28 // CLASS DECLARATION

    29 

    30 /**

    31 *  CUPnPAiwOpenExternalService

    32 *  The class implements the "Open external" service of the

    33 *  UPnP AIW Media Provider.

    34 *  @since Series S60 3.0

    35 */

    36 class CUPnPAiwOpenExternalService : public CAiwServiceIfBase

    37     {

    38 

    39     public: // Constructors and destructor

    40 

    41         // Two-phased constructor.

    42         static CUPnPAiwOpenExternalService* NewL();

    43         

    44         // Destructor.

    45         virtual ~CUPnPAiwOpenExternalService();

    46 

    47     public: // Methods from the CAiwServiceIfMenu

    48 

    49         // Unnecessary method

    50         void InitialiseL( MAiwNotifyCallback& /*aFrameworkCallback*/,

    51                           const RCriteriaArray& /*aInterest*/) {}

    52 

    53         /**

    54         * Executes generic service commands included in criteria.

    55         * @param aCmdId Command to be executed

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

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

    58         * @param aCmdOptions Options for the command, see KAiwCmdOpt* 

    59         *        constants.

    60         * @param aCallback callback for asynchronous command handling, 

    61         *        parameter

    62         *        checking, etc.

    63         * @see enum TServiceCmdOptions in GENERICPARAM.HRH

    64         * @exception KErrArgument if callback is missing when required.

    65         * @exception KErrNotSupported if no provider support service

    66         */

    67         void HandleServiceCmdL( const TInt& aCmdId,

    68                                 const CAiwGenericParamList& aInParamList,

    69                                 CAiwGenericParamList& aOutParamList,

    70                                 TUint aCmdOptions = 0,

    71                                 const MAiwNotifyCallback* aCallback = NULL);

    72 

    73     private: // construction

    74 

    75         // Constructor

    76         CUPnPAiwOpenExternalService();

    77 

    78         // ConstructL

    79         void ConstructL();

    80 

    81     private: // Data members

    82 

    83         // reference to the engine component

    84         CUPnPAiwEngine* iEngine;                // not owned (singleton)

    85 

    86     };

    87 

    88 #endif // _UPNP_AIW_OPEN_EXTERNAL_SERVICE_H

    89 

    90 // End of file