--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/networkprotocolmodules/suplprotocolmodule/SuplPushAPI/inc/lbssuplpush.h Tue Feb 02 01:50:39 2010 +0200
@@ -0,0 +1,119 @@
+// Copyright (c) 2007-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:
+// Location Based Services SUPL Push API
+//
+//
+
+/**
+ @file
+ @publishedPartner
+ @deprecated
+*/
+#ifndef SUPL_PUSH_H
+#define SUPL_PUSH_H
+
+
+//-------------------------------------------------------------------------------
+#include <e32base.h>
+#include <lbs/lbssuplpushcommon.h>
+
+//-------------------------------------------------------------------------------
+class CLbsSuplPushImpl;
+
+
+//-------------------------------------------------------------------------------
+/**
+The MLbsSuplPushObserver class provides a call-back type of interface that must be
+used together with the CLbsSuplPush class. A class using the CLbsSuplPush interface must
+derive from MLbsSuplPushObserver and implement appropriate virtual methods in order
+to receive notifications about request completions.
+
+@publishedPartner
+@deprecated
+@see CLbsSuplPush
+*/
+class MLbsSuplPushObserver
+ {
+public:
+ IMPORT_C virtual TVersion Version() const;
+
+ /**
+ Receive notification that the SUPL Init message has been sent to the LBS sub-system.
+ The call-back is invoked immediately after delivery of the SUPL INIT request and
+ does not provide any information about it's outcome, e.g. conflict control results,
+ host validation results, connection results etc.
+
+ @param aChannel [In] The channel the call-back is related to.
+ @param aReqId [In] An Id of the request the call-back is related to.
+ @param aError [In] KErrNone if successful, KErrTimeout if it was not possible to deliver
+ the request before the timeout period, KErrArgument if the structure
+ or content of the SUPL INIT message was incorrect.
+ Any system wide error code otherwise.
+ @param aReserved [In] Reserved for future use.
+
+ @see CLbsSuplPush::SuplInit
+ */
+ virtual void OnSuplInitComplete(TLbsSuplPushChannel aChannel, TLbsSuplPushRequestId aReqId, TInt aError, TInt aReserved) = 0;
+
+protected:
+ /**
+ Should not be used. Provides for future expansion of the observer interface.
+ Currently not implemented.
+ */
+ IMPORT_C virtual TAny* ExtendedInterface(TInt aFunctionNumber, TAny* aPtr1, TAny* aPtr2);
+ };
+
+
+//-------------------------------------------------------------------------------
+/**
+The CLbsSuplPush class provides an interface to send SUPL INIT Push messages into
+the LBS sub-system. Normally SUPL INIT messages arrive through SMS or WAP push
+and, if accepted, result in the opening of a a TCP/IP connection to the SLP (SUPL Server).
+
+Although it is possible for multiple threads to open a channel of the same type
+(e.g. SMS or WAP), only one thread can actively use the channel at any time. A system
+requiring concurrent access to a channel must provide its own access control mechanism.
+
+Unless documented explicitly, no assumptions should be made about the order and/or
+content of notifications generated by the LBS sub-system through this or
+other interfaces.
+
+@publishedPartner
+@deprecated
+@see MLbsSuplPushObserver
+*/
+NONSHARABLE_CLASS(CLbsSuplPush) : public CBase
+ {
+public:
+ IMPORT_C static CLbsSuplPush* NewL(TLbsSuplPushChannel aChannel, MLbsSuplPushObserver& aObserver);
+ virtual ~CLbsSuplPush();
+
+public:
+ IMPORT_C TInt SuplInit(TLbsSuplPushRequestId& aReqId, const TDesC8& aMsg, TInt aReserved);
+
+private:
+ CLbsSuplPush();
+ void ConstructL(TLbsSuplPushChannel aChannel, MLbsSuplPushObserver& aObserver);
+
+ //** Prohibit copy constructor */
+ CLbsSuplPush(const CLbsSuplPush&);
+ //** Prohibit assigment operator */
+ CLbsSuplPush& operator= (const CLbsSuplPush&);
+
+private:
+ /** CLbsSuplPushImpl* Impl is the internal handle to the Implementation */
+ CLbsSuplPushImpl* iImpl;
+ };
+
+#endif //SUPL_PUSH_H