1 /*

     2 * Copyright (c) 2002-2004 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:  Object Negotiators.

    15 *

    16 */

    17 

    18 

    19 #ifndef MPHSRVEMERGENCYNEGOTIATORS_H

    20 #define MPHSRVEMERGENCYNEGOTIATORS_H

    21 

    22 

    23 // INCLUDES

    24 #include <e32base.h>

    25 #include <phclttypes.h> 

    26 

    27 

    28 // FORWARD DECLARATIONS

    29 class MPhSrvEmergencyCall;

    30 class CPhSrvSubSessionBase;

    31 

    32 

    33 // CLASS DECLARATION

    34 

    35 /**

    36 *  Base class for call negotiators.

    37 *

    38 *  @since 1.0

    39 */

    40 class MPhSrvEmergencyCallBase

    41     {

    42     public: // New functions

    43 

    44         /**

    45         * Makes an dial request.

    46         *

    47         * @param aMessage Message to be negotiated.

    48         * @param aArgs Call arguments.

    49         * @param aSubSession Subsession for dial.

    50         */

    51         virtual void EmergencyDialL( 

    52            const RMessage2& aMessage) = 0;

    53            

    54           

    55         /**

    56         * Cancel's an oustanding dial request. If the specified subsession 

    57         * doesn't have an oustanding dial request, then the subsession is 

    58         * panicked.

    59         *

    60         * @param aSubSession Subsession that has the dial request.

    61         */

    62         virtual void EmergencyDialCancel() = 0;

    63     };

    64 

    65 /**

    66 *  Abstract call negotiators class.

    67 *

    68 *  @since 1.0

    69 */

    70 class MPhSrvEmergencyNegotiatorCall : public MPhSrvEmergencyCallBase

    71     {

    72     public: // New functions

    73 

    74         /**

    75         * Called by the call notifier subsession when it's ready to negotiate

    76         * (make another call) with the external call interface.

    77         *

    78         * @param aInitiator Call initiator instance.

    79         */

    80         virtual void SetNegotiatorReadyCall( 

    81             MPhSrvEmergencyCall& aInitiator ) = 0;

    82 

    83         /**

    84         * Called by the call notifier subsession when it isn't going to be

    85         * available to make further calls (session has closed)

    86         *

    87         * @param aInitiator Call initiator instance.

    88         */

    89         virtual void SetNegotiatorReadyCallCancel( 

    90             MPhSrvEmergencyCall& aInitiator ) = 0;

    91 

    92         /**

    93         * Called by the call notifier subsession when it's attempted to make a

    94         * call - the call negotiator can then inform the external call 

    95         * interface of the result.

    96         *

    97         * @param aResult Result of the call attempt.

    98         */

    99         virtual void SetNegotiatorAttemptedCallResponseValue( 

   100             TPhCltPhoneResults aResult ) = 0;

   101     };

   102 

   103 

   104 #endif // MPHSRVEMERGENCYNEGOTIATORS_H

   105 

   106 

   107 // End of File