1 // Copyright (c) 2001-2009 Nokia Corporation and/or its subsidiary(-ies).

     2 // All rights reserved.

     3 // This component and the accompanying materials are made available

     4 // under the terms of "Eclipse Public License v1.0"

     5 // which accompanies this distribution, and is available

     6 // at the URL "http://www.eclipse.org/legal/epl-v10.html".

     7 //

     8 // Initial Contributors:

     9 // Nokia Corporation - initial contribution.

    10 //

    11 // Contributors:

    12 //

    13 // Description:

    14 //

    15 

    16 /**

    17  @file MWspCLMethodCallback.h

    18  @warning : This file contains Rose Model ID comments - please do not delete

    19 */

    20 

    21 #ifndef __MWSPCLMETHODCALLBACK_H__

    22 #define __MWSPCLMETHODCALLBACK_H__

    23 

    24 // System includes

    25 #include <e32base.h>

    26 

    27 // Forward declarations

    28 class MWspCLMethodInvoker;

    29 

    30 class MWspCLMethodCallback

    31 /**

    32 @class MWspCLMethodCallback

    33 @since			7.0

    34 The MWspCLMethodInvoker and MWspCLMethodCallback form the API that provides

    35 the WSP Connectionless Session Service Method Invocation facility, as 

    36 described in the WSP Specification, July 2001. 

    37 

    38 The MWspCLMethodInvoker interface is supplied by the Provider entity. The 

    39 MWspCLMethodCallback interface is supplied by the Client entity. The 

    40 Provider implements the communications necessary to send the primitives 

    41 issued by the Client to the Server, and from the Server to the Client.

    42 

    43 The Client object that encapsulates a method transaction implements the call-back

    44 API MWspCLMethodCallback. Internally, the Provider should associate each of these

    45 objects with a WSP Transaction Id in order to distinguish between method transactions.

    46 @publishedAll

    47 @deprecated

    48 */

    49 	{

    50 public:	// Methods

    51 

    52 /**

    53 	@fn				UnitMethodResultInd(TInt aStatus, const TDesC8& aResponseHeaders, const TDesC8& aResponseBody) =0

    54 	Intended Usage	:	This represents the S-Unit-MethodResult.ind primitive. 

    55 						The Provider issues this when it receives a method

    56 						response from the Server.

    57 	@since			7.0

    58 	@param			aStatus				A status code whose value is given by 

    59 										the Status types defined in the WSP 

    60 										Specification, July 2001 .

    61 	@param			aResponseHeaders	A buffer with the encoded request header.

    62 	@param			aResponseBody		A buffer with the data associated with the 

    63 										request. Only used if the method aMethod 

    64 										supports an entity body.

    65 	@pre 			There is a MWspCLMethodCallback object associated with the 

    66 					Transaction Id in the S-Unit-MethodResult.ind primitive.

    67 	@post			The MWspCLMethodCallback object associated with the Transaction

    68 					Id in the S-Unit-MethodResult.ind primitive is no longer valid.

    69  */

    70 	virtual void UnitMethodResultInd(

    71 									TInt			aStatus, 

    72 									const TDesC8&	aResponseHeaders, 

    73 									const TDesC8&	aResponseBody

    74 									) =0;

    75 

    76 	};

    77 

    78 #endif	// __MWSPCLMETHODCALLBACK_H__