1 /*

     2 * Copyright (c) 2002 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 *      MPsetBarringObserver class defines protocol for reporting

    16 *      barring events to barring observer.     

    17 *

    18 *

    19 */

    20 

    21 

    22 #ifndef     MPSETBARRINGOBS_H

    23 #define     MPSETBARRINGOBS_H

    24 

    25 //  INCLUDES

    26 #include "nwdefs.h"

    27 #include "MPsetCallBarring.h"

    28 

    29 //  CLASS DEFINITIONS 

    30 /**

    31 *  MPsetBarringObserver class is virtual class for call barring observers.

    32 *  @lib phonesettings.lib

    33 *  @since 1.0

    34 */

    35 class MPsetBarringObserver

    36     {

    37     public:      

    38 

    39         /**

    40         * Handles mode changed notes.

    41         *

    42         * @param aType Type of barring program.

    43         * @param aStatus Status of the barring program.

    44         * @param aPlural Plural notes should be used.

    45         */

    46         virtual void HandleBarringModeChangedL( TBarringProgram aType, 

    47               TBarringStatus aStatus, TBool aPlural ) = 0;        

    48         

    49          /**

    50         * Handles barring mode inquiry notes.

    51         *

    52         * @param aType Type of barring program.

    53         * @param aStatus Status of the barring program.

    54         */

    55         virtual void HandleBarringModeStatusL( TUint8 aBsc[KPSetNumberOfBsc], 

    56                     TBarringStatus aStatus ) = 0;

    57         

    58         /**

    59         * Handles errors in call barring requests.

    60         *

    61         * @param aReason Reason for error.

    62         */

    63         virtual void HandleBarringErrorL( TInt aReason ) = 0;

    64 

    65         /**

    66         * Handles requesting notes.

    67         *

    68         * @param aTrue Is there a request going on.

    69         * @param aInterrupted Request needs to be immediately cancelled.

    70         */

    71         virtual void HandleCBRequestingL( TBool aTrue, 

    72             TBool aInterrupted ) = 0; 

    73         

    74         /**

    75         * Sets pointer so that message is passed succesfully

    76         * from requester to observer.

    77         *

    78         * @param aBarringEngine Source of events to observer.

    79         */

    80         virtual void SetEngineContact( MPsetCallBarring* aBarringEngine ) = 0;

    81 

    82         /**

    83         * Handles notes relating to cb password change requests.

    84         *

    85         * @param aSuccess Result of teh change request.

    86         */

    87         virtual void CbPasswordChangedL( TBool aSuccess ) = 0;

    88 

    89     };

    90 #endif      //  MPSETBARRINGOBS_H

    91 // End of File