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 MPHSRVOBJECTNEGOTIATORS_H

    20 #define MPHSRVOBJECTNEGOTIATORS_H

    21 

    22 

    23 // INCLUDES

    24 #include <e32base.h>

    25 #include <PhCltTypes.h>

    26 

    27 

    28 // FORWARD DECLARATIONS

    29 class MPhSrvInitiatorCall;

    30 class MPhSrvInitiatorStatus;

    31 class CPhSrvSubSessionBase;

    32 

    33 

    34 // CLASS DECLARATION

    35 

    36 /**

    37 *  Base class for call negotiators.

    38 *

    39 *  @since 1.0

    40 */

    41 class MPhSrvNegotiatorCallBase

    42     {

    43     public: // New functions

    44 

    45         /**

    46         * Makes an dial request.

    47         *

    48         * @param aMessage Message to be negotiated.

    49         * @param aArgs Call arguments.

    50         * @param aSubSession Subsession for dial.

    51         */

    52         virtual void NegotiatorDialL( 

    53             const RMessage2& aMessage, 

    54             const TPhCltCallArgs& aArgs, 

    55             CPhSrvSubSessionBase& aSubSession ) = 0;

    56 

    57         /**

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

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

    60         * panicked.

    61         *

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

    63         */

    64         virtual void NegotiatorDialCancel( 

    65             CPhSrvSubSessionBase& aSubSession ) = 0;

    66     };

    67 

    68 

    69 /**

    70 *  Abstract call negotiators class.

    71 *

    72 *  @since 1.0

    73 */

    74 class MPhSrvNegotiatorCall : public MPhSrvNegotiatorCallBase

    75     {

    76     public: // New functions

    77 

    78         /**

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

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

    81         *

    82         * @param aInitiator Call initiator instance.

    83         */

    84         virtual void SetNegotiatorReadyCall( 

    85             MPhSrvInitiatorCall& aInitiator ) = 0;

    86 

    87         /**

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

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

    90         *

    91         * @param aInitiator Call initiator instance.

    92         */

    93         virtual void SetNegotiatorReadyCallCancel( 

    94             MPhSrvInitiatorCall& aInitiator ) = 0;

    95 

    96         /**

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

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

    99         * interface of the result.

   100         *

   101         * @param aResult Result of the call attempt.

   102         */

   103         virtual void SetNegotiatorAttemptedCallResponseValue( 

   104             TPhCltPhoneResults aResult ) = 0;

   105     };

   106 

   107 #endif // MPHSRVOBJECTNEGOTIATORS_H

   108 

   109 

   110 // End of File