--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/syncmlfw/syncmlnotifier/inc/SyncMLAppLaunchNotifier.h Wed Sep 01 12:27:42 2010 +0100
@@ -0,0 +1,252 @@
+/*
+* Copyright (c) 2005 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: Server alerts for Data Sync and Device Management engines.
+*
+*
+*/
+
+
+
+#ifndef CSYNCMLAPPLAUNCHNOTIFIER_H
+#define CSYNCMLAPPLAUNCHNOTIFIER_H
+
+// INCLUDES
+#include <SyncMLClient.h>
+
+#include <SyncMLNotifierParams.h>
+#include "SyncMLNotifierBase.h" // Base class
+#include <SyncService.h>
+#include <centralrepository.h>
+#include <e32property.h>
+// CONSTANTS
+// From S60\SyncMLFota
+const TUid KUidNSmlMediumTypeInternet = { 0x101F99F0 };
+_LIT8( KNSmlIAPId, "NSmlIapId" );
+_LIT8( KNSmlAlwaysAsk, "-1" );
+const TInt KDefaultTimeoutforNotes ( 30 );
+const TUid KDisclaimerProperty = {0x101F8769};
+const TUint32 KDisclaimerInteger = 0x00000001;
+
+const TUid KCRUidNSmlDSApp = { 0x101F9A1D };
+// CLASS DECLARATION
+
+class CDMDisclaimerObserver;
+/**
+* Notifier for launching SyncML applications
+*
+* @lib SyncMLNotifier
+* @since Series 60 3.0
+*/
+NONSHARABLE_CLASS( CSyncMLAppLaunchNotifier ) : public CSyncMLNotifierBase
+ {
+ public: // Constructors and destructor
+ enum TSanSupport
+ {
+ EOff,EON
+ };
+ /**
+ * Two-phased constructor.
+ */
+ static CSyncMLAppLaunchNotifier* NewL();
+
+ /**
+ * Destructor.
+ */
+ virtual ~CSyncMLAppLaunchNotifier();
+
+ public:
+ /**
+ * Returns correct SyncService depending on the Service Id
+ * @param aServiceId
+ * @return CSyncService*
+ */
+ CSyncService* SyncServiceL( TUint aServiceId );
+
+ /**
+ * Called to complete the message
+ * @param aDisclaimerAccepted
+ */
+ void CompleteMessageL(TInt aDisclaimerAccepted);
+
+ private: // New functions
+
+ /**
+ * Retrieves required parameters for the note and launching of the
+ * synchronization application.
+ * @param aParam Parameter structure that is forwarded to syncservice
+ * @param aServerName Returns the clear-text name of the corresponding server.
+ * @param aUserInteraction Returns the profile setting of whether the user
+ * acceptance should be queried.
+ * @return None
+ */
+ void RetrieveSyncParamsL( TSyncServiceParam& aParam,
+ TDes& aServerName,
+ TSmlServerAlertedAction& aUserInteraction );
+
+ /**
+ * Retrieves required parameters for the note and launching of the
+ * device management application.
+ * @param aParam Parameter structure that is forwarded to syncservice
+ * @param aServerName Returns the clear-text name of the corresponding server.
+ * @param aUserInteraction Returns the profile setting of whether the user
+ * acceptance should be queried.
+ * @return None
+ */
+ void RetrieveMgmtParamsL( TSyncServiceParam& aParam,
+ TDes& aServerName,
+ TSmlServerAlertedAction& aUserInteraction );
+
+ /**
+ * Checks if the user and/or parameters have defined that the session
+ * should be accepted without querying the user.
+ * @param aUserInteraction Sync profile interaction enumeration.
+ * @return True, if the session is accepted automatically.
+ */
+ TBool IsSilent( TSmlServerAlertedAction& aUserInteraction );
+
+ private: // Functions from base classes
+
+ /**
+ * From CSyncMLNotifierBase Called when a notifier is first loaded.
+ * @param None.
+ * @return A structure containing priority and channel info.
+ */
+ TNotifierInfo RegisterL();
+
+ /**
+ * From CSyncMLNotifierBase The notifier has been deactivated
+ * so resources can be freed and outstanding messages completed.
+ * @param None.
+ * @return None.
+ */
+ void Cancel();
+
+ /**
+ * From CSyncMLNotifierBase Used in asynchronous notifier launch to
+ * store received parameters into members variables and
+ * make needed initializations.
+ * @param aBuffer A buffer containing received parameters
+ * @param aReturnVal The return value to be passed back.
+ * @param aMessage Should be completed when the notifier is deactivated.
+ * @return None.
+ */
+ void GetParamsL( const TDesC8& aBuffer,
+ TInt aReplySlot,
+ const RMessagePtr2& aMessage );
+
+ /**
+ * From CSyncMLNotifierBase Gets called when a request completes.
+ * @param None.
+ * @return None.
+ */
+ void RunL();
+ /**
+ * From CSyncMLNotifierBase Gets called when RunL leaves.
+ * @param aError.
+ * @return TInt.
+ */
+ TInt RunError(TInt aError);
+ /**
+ * From RConnectionMonitor gets the staus of roaming .
+ * If roaming returns true else returns false
+ * @param ret
+ * @return None.
+ */
+ void IsRoamingL(TBool& ret);
+ /**
+ * HandleDMSession
+ * @param ret
+ * @return TBool
+ */
+ TBool HandleDMSessionL();
+ /**
+ * HandleCompleteMessage
+ * @param TInt &keypress, TBool &silent, TInt &SanSupport, TInt &Timeout, TInt &CustomNotes
+ * @return None.
+ */
+ void HandleCompleteMessageL(TInt &keypress, TBool &silent, TInt &SanSupport, TInt &Timeout, TInt &CustomNotes);
+ /**
+ * IsLanguageSupported
+ * @param ret
+ * @return True if the language is supported.
+ */
+ TBool IsLanguageSupportedL();
+
+ void ReadRepositoryL(TInt aKey, TInt& aValue);
+
+ void ShowRoamingMessageL(TInt keypress, TUint profileId);
+
+ private:
+
+ /**
+ * C++ default constructor.
+ */
+ CSyncMLAppLaunchNotifier();
+
+ private: // Data
+ // Type of session queried
+ TSyncMLSessionTypes iSmlProtocol;
+ CDMDisclaimerObserver* iObserver;
+
+ // Job identifier from the parameters
+ TInt iJobId;
+
+ // Identifier of the used SyncML profile from the parameters
+ TInt iProfileId;
+
+ // Sync Service for Data Sync
+ CSyncService* iDSSyncService;
+ // Sync Service for Device Management
+ CSyncService* iDMSyncService;
+ // Is always ask selected as accesspoint for current profile
+ TBool iAlwaysAsk;
+ // Alert mode
+ TInt iUimode;
+ // DM Sync Server
+ TBuf<KSyncMLMaxProfileNameLength> DMSyncServerName;
+ // UI behaviour
+ TSmlServerAlertedAction uiAction;
+ // Sync Service param
+ TSyncServiceParam param;
+ // Stringholder
+ HBufC* stringholder;
+ // Central Respository
+ CRepository* centrep;
+ // To store the bearer type
+ TInt iBearerType;
+ };
+
+/**
+* CDMDisclaimerObserver class
+*
+*/
+class CDMDisclaimerObserver : public CActive
+ {
+ public:
+ CDMDisclaimerObserver();
+ ~CDMDisclaimerObserver();
+ void WaitOnDisclaimerL(CSyncMLAppLaunchNotifier* aPtr);
+ protected:
+ void DoCancel();
+ void RunL();
+ TInt RunError(TInt aError);
+ private:
+ TInt iPropertyVal;
+ RProperty iDisclaimerProperty;
+ CSyncMLAppLaunchNotifier* iNot;
+ };
+
+#endif // CSYNCMLAPPLAUNCHNOTIFIER_H
+
+// End of File