epoc32/include/lbs/lbssuplpushreceiver.h
branchSymbian3
changeset 4 837f303aceeb
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/epoc32/include/lbs/lbssuplpushreceiver.h	Wed Mar 31 12:33:34 2010 +0100
     1.3 @@ -0,0 +1,110 @@
     1.4 +// Copyright (c) 2007-2009 Nokia Corporation and/or its subsidiary(-ies).
     1.5 +// All rights reserved.
     1.6 +// This component and the accompanying materials are made available
     1.7 +// under the terms of "Eclipse Public License v1.0"
     1.8 +// which accompanies this distribution, and is available
     1.9 +// at the URL "http://www.eclipse.org/legal/epl-v10.html".
    1.10 +//
    1.11 +// Initial Contributors:
    1.12 +// Nokia Corporation - initial contribution.
    1.13 +//
    1.14 +// Contributors:
    1.15 +//
    1.16 +// Description:
    1.17 +// Location Based Services SUPL Push Receiver API
    1.18 +// 
    1.19 +//
    1.20 +
    1.21 +/**
    1.22 + @file
    1.23 + @publishedPartner
    1.24 + @deprecated
    1.25 +*/
    1.26 +#ifndef SUPL_PUSH_RECEIVER_H
    1.27 +#define SUPL_PUSH_RECEIVER_H
    1.28 +
    1.29 +
    1.30 +//-------------------------------------------------------------------------------
    1.31 +#include <e32base.h>
    1.32 +#include <lbs/lbssuplpushcommon.h>
    1.33 +
    1.34 +//-------------------------------------------------------------------------------
    1.35 +class CLbsSuplPushRecImpl;
    1.36 +
    1.37 +//-------------------------------------------------------------------------------
    1.38 +/**
    1.39 +The MLbsSuplPushRecObserver class provides a call-back type of interface that must be
    1.40 +used together with the CLbsSuplPushRec class. It is used by the SUPL Protocol Module.
    1.41 +A class using the CLbsSuplPushRec interface must derive from MLbsSuplPushRecObserver
    1.42 +and implement appropriate virtual methods in order to receive notifications about
    1.43 +incoming SUPL INIT messages.
    1.44 +
    1.45 +@publishedPartner
    1.46 +@deprecated
    1.47 +
    1.48 +@see CLbsSuplPushRec
    1.49 +*/
    1.50 +class MLbsSuplPushRecObserver
    1.51 +	{
    1.52 +public:
    1.53 +	IMPORT_C virtual TVersion Version() const;
    1.54 +
    1.55 +	/**
    1.56 +	Receive notification about an incoming SUPL INIT message. 
    1.57 +	
    1.58 +	@param aChannel  [In] The channel the call-back is related to.
    1.59 +	@param aReqId    [In] An Id of the request the call-back is related to.
    1.60 +	@param aMsg      [In] A buffer containing a SUPL INIT message.
    1.61 +	
    1.62 +	@see CLbsSuplPushRec::SuplInitComplete
    1.63 +	@see CLbsSuplPush::SuplInit
    1.64 +	*/
    1.65 +	virtual void OnSuplInit(TLbsSuplPushChannel aChannel, TLbsSuplPushRequestId aReqId, TDesC8& aMsg) = 0;
    1.66 +
    1.67 +protected:			
    1.68 +	/**
    1.69 +	Should not be used. Provides for future expansion of the observer interface. 
    1.70 +	Currently not implemented
    1.71 +	*/  
    1.72 +	IMPORT_C virtual TAny* ExtendedInterface(TInt aFunctionNumber, TAny* aPtr1, TAny* aPtr2);
    1.73 +	};
    1.74 +
    1.75 +
    1.76 +//-------------------------------------------------------------------------------
    1.77 +/**
    1.78 +The CLbsSuplPushRec class provides an interface to allow SUPL INIT messages to be
    1.79 +received from SMS or WAP Push frameworks. It is used by the SUPL Protocol Module.
    1.80 +SUPL INIT messages are sent into the LBS subsystem using the CLbsSuplPush class.
    1.81 +
    1.82 +@publishedPartner
    1.83 +@deprecated
    1.84 +@see MLbsSuplPushRecObserver
    1.85 +@see CLbsSuplPush
    1.86 +*/
    1.87 +NONSHARABLE_CLASS(CLbsSuplPushRec) : public CBase
    1.88 +	{
    1.89 +public:
    1.90 +	IMPORT_C static CLbsSuplPushRec* NewL(MLbsSuplPushRecObserver& aObserver);
    1.91 +	virtual ~CLbsSuplPushRec();
    1.92 +	
    1.93 +public:
    1.94 +	IMPORT_C TInt SuplInitComplete(TLbsSuplPushChannel aChannel, 
    1.95 +								   TLbsSuplPushRequestId aReqId, 
    1.96 +								   TInt aError, 
    1.97 +								   TInt aReserved);
    1.98 +	
    1.99 +private:
   1.100 +	CLbsSuplPushRec();
   1.101 +	void ConstructL(MLbsSuplPushRecObserver& aObserver);
   1.102 +	
   1.103 +	//** Prohibit copy constructor */
   1.104 +	CLbsSuplPushRec(const CLbsSuplPushRec&);
   1.105 +	//** Prohibit assigment operator */
   1.106 +	CLbsSuplPushRec& operator= (const CLbsSuplPushRec&);
   1.107 +
   1.108 +private:
   1.109 +	/** CLbsSuplPushRecImpl* Impl is the internal handle to the Implementation */
   1.110 +	CLbsSuplPushRecImpl* iImpl;
   1.111 +	};
   1.112 +
   1.113 +#endif //SUPL_PUSH_RECEIVER_H