1 /*

     2 * Copyright (c) 2005-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 the License "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 MIptvServiceManagementClientObserver class*

    15 */

    16 

    17 

    18 

    19 #ifndef __MIPTVSERVICEMANAGEMENTCLIENTOBSERVER_H__

    20 #define __MIPTVSERVICEMANAGEMENTCLIENTOBSERVER_H__

    21 

    22 #include "CIptvNetworkSelection.h"

    23 #include "CIptvService.h"

    24 

    25 class CDesC8ArraySeg;

    26 class CIptvSmEvent;

    27 

    28 // CLASS DECLARATION

    29 

    30 /**

    31 * MIptvServiceManagementClientObserver

    32 * class specifies the interface for CIptvServiceManagementClient callback functions.

    33 * Client must inherit this and implement the virtual functions.

    34 */

    35 class MIptvServiceManagementClientObserver

    36     {

    37     

    38     public: // Enumerations

    39     

    40         /**

    41         * TRespStatus.

    42         * Response statuses for requests.

    43         */

    44         enum TRespStatus

    45             {

    46             ESucceeded,

    47             EServiceNotFound,

    48             EGeneralError,

    49             ECancelled,

    50             EEmpty            

    51             };

    52 

    53     public:

    54 

    55         /**

    56         * AddServiceResp.

    57         * Callback function for AddServiceReq operation.

    58         * @param aRespStatus

    59         */

    60         virtual void AddServiceResp(TRespStatus aRespStatus) = 0;

    61 

    62         /**

    63         * UpdateServiceResp.

    64         * Callback function for UpdateServiceReq.

    65         * @param aRespStatus

    66         */

    67         virtual void UpdateServiceResp(TRespStatus aRespStatus) = 0;

    68 

    69 

    70         /**

    71         * DeleteServiceResp.

    72         * Callback function for DeleteServiceReq operation.

    73         * @param aRespStatus

    74         */        

    75         virtual void DeleteServiceResp(TRespStatus aRespStatus) = 0;

    76 

    77         /**

    78         * GetServicesResp.

    79         * Callback function for GetServicesReq() methods.

    80         * @param aRespStatus ESucceeded is returned even if no matching

    81         *        services were found. In that case the aServicesArray contains

    82         *        empty array. If aRespStatus != ESucceeded, aServicesArray

    83         *        pointer is NULL.

    84         * @param aServicesArray contains array of pointers to descriptors.

    85         *        aServicesArray ownership moves from server to client, ie client

    86         *        is responsible for freeing the array.

    87         *        Array elements are binary descriptors built with CIptvService::GetL() method.

    88         *        CIptvService::SetL() method can be used to init CIptvService class with

    89         *        array element data.

    90         *        In case of error, aServicesArray is NULL.

    91         */

    92         virtual void GetServicesResp(TRespStatus aRespStatus, 

    93                                      CDesC8ArraySeg* aServicesArray) = 0;

    94 

    95         /**

    96         * GetUsedIapResp.

    97         * Callback function for GetUsedIapReq() method.

    98         * @param aIapId IAP ID which client should use when connecting to service.

    99         * @param aIapName

   100         * @param aConnectionPermission

   101         * @param aWlanWhenGPRS

   102         * @param aRespStatus If != ESucceeded, aIapId, aIapName and aConnectionPermission

   103         *                    do not contain valid data.

   104         */

   105         virtual void GetUsedIapResp(TUint32 aIapId,

   106                                     const TDesC& aIapName,

   107                                     CIptvNetworkSelection::TConnectionPermission aConnectionPermission,

   108                                     TBool   aWlanWhenGPRS,

   109                                     CIptvNetworkSelection::TRespStatus aRespStatus

   110                                     ) = 0;

   111 

   112         /**

   113         * ServerShutdownResp.

   114         * Callback function for ServerShutdownReq operation.

   115         * @param aRespStatus

   116         */

   117         virtual void ServerShutdownResp(TRespStatus aRespStatus) = 0;

   118 

   119         /**

   120         * Service Manager generated events handle function.

   121         * @param aEvent

   122         */        

   123         virtual void HandleSmEvent(CIptvSmEvent& aEvent) = 0;

   124 

   125     };

   126 

   127 #endif // __MIPTVSERVICEMANAGEMENTCLIENTOBSERVER_H__