--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/applayerpluginsandutils/httpprotocolplugins/wspinc/MWspCLPushInvoker.h Tue Feb 02 01:09:52 2010 +0200
@@ -0,0 +1,89 @@
+// Copyright (c) 2001-2009 Nokia Corporation and/or its subsidiary(-ies).
+// All rights reserved.
+// This component and the accompanying materials are made available
+// under the terms of "Eclipse Public License v1.0"
+// which accompanies this distribution, and is available
+// at the URL "http://www.eclipse.org/legal/epl-v10.html".
+//
+// Initial Contributors:
+// Nokia Corporation - initial contribution.
+//
+// Contributors:
+//
+// Description:
+//
+
+/**
+ @file MWspCLPushInvoker.h
+ @warning : This file contains Rose Model ID comments - please do not delete
+*/
+
+#ifndef __MWSPCLPUSHINVOKER_H__
+#define __MWSPCLPUSHINVOKER_H__
+
+// System includes
+#include <e32base.h>
+
+// Forward declarations
+class MWspCLPushCallback;
+
+
+class MWspCLPushInvoker
+/**
+@class MWspCLPushInvoker
+@since 7.0
+The MWspCLPushInvoker and MWspCLPushCallback form the API that provides the
+WSP Connectionless Session Service Push facility, as in the WSP Specification,
+July 2001. The MWspCLMethodInvoker interface is supplied by the Provider
+entity. The MWspCLMethodCallback interface is supplied by the Client entity.
+The Provider implements the communications necessary to send the primitives
+issued by the Client to the Server, and from the Server to the Client.
+
+The Client object that encapsulates a push transaction implements the call-back
+API MWspCLPushCallback. Internally, the Provider should associate each of these
+objects with a WSP Push Id in order to distinguish between push transactions.
+@publishedAll
+@deprecated
+*/
+ {
+public: // Methods
+
+/**
+ @fn InitPushReceive(MWspCLPushCallback& aPushCallback) =0
+ Intended Usage : Supplies the Provider with a Push transaction object.
+ Also, informs the Provider that the Client is ready to
+ receive Push information. The Provider uses this call-
+ back object to pass Push information to the Client.
+ @since 7.0
+ @param aPushCallback A reference to an instance of the call-back
+ API MWspCLPushCallback.It uniquely identifies
+ this method transaction for the lifetime of
+ the transaction.
+ @pre The underlying layers are prepared for communication.
+ @post The Provider is waiting for a S-Unit-Push primitive from
+ the Server. Increases the number of listening Push
+ transactions by one.
+ */
+ virtual void InitPushReceive(MWspCLPushCallback& aPushCallback) =0;
+
+/**
+ @fn CancelPushReceive(MWspCLPushCallback& aPushCallback) =0
+ Intended Usage : Removes the listening Push transaction. The Client no
+ longer wishes to receive Push information via the
+ specified MWspCLPushCallback object.
+ @since 7.0
+ @param aPushCallback A reference to an instance of the call-back
+ API MWspCLPushCallback.It uniquely identifies
+ this method transaction for the lifetime of
+ the transaction.
+ @pre The Push transaction object is exists.
+ @post The aPushCallback object is no longer valid. The number of
+ listening Push transaction objects in the Provider is reduced
+ by one.
+ */
+ virtual void CancelPushReceive(MWspCLPushCallback& aPushCallback) =0;
+
+ };
+
+#endif // __MWSPCLPUSHINVOKER_H__
+