telephonyprotocols/pdplayer/inc/authenticationdialog.h
branchRCL_3
changeset 21 2492a6e4aed7
child 24 6638e7f4bd8f
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/telephonyprotocols/pdplayer/inc/authenticationdialog.h	Tue Apr 27 17:51:07 2010 +0300
@@ -0,0 +1,78 @@
+// Copyright (c) 2010 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:
+// Interface between the PDP and the connection agent dialog server.
+//
+
+/**
+ @file
+ @internalComponent
+*/
+
+#ifndef SYMBIAN_AUTHENTICATION_DIALOG_H
+#define SYMBIAN_AUTHENTICATION_DIALOG_H
+
+#include <e32base.h>
+#include <agentdialog.h>
+
+class MAuthenticationDialogObserver
+/**
+MAuthenticationDialogObserver
+
+Mixin observer class to be derived from by classes wishing to use CAuthenticationDialog.
+When the Authenticate function call completes the AuthenticationComplete function will
+be called on the observer.
+@internalTechnology
+*/
+    {
+public:
+    virtual void AuthenticationCompleteL(TInt aError) = 0;
+    };
+
+class CAuthenticationDialog : public CActive
+/**
+CAuthenticationDialog
+
+Has an RGenConAgentDialogServer class which provides the interface
+to the dialog server.
+
+@internalTechnology
+*/
+    {
+public:
+    static CAuthenticationDialog* NewL(TInt aPriority = CActive::EPriorityStandard);
+    ~CAuthenticationDialog();
+
+    /**
+     * The aIsReconnect parameter indicates to the dialog server if it is a reconnection attempt.
+     * The reasoning behind providing this information is that the dialog server implementation may choose to 
+     * suppress the dialog if this is a reconnection and just silently return the values entered by the user 
+     * at the first connection attempt. Here the dafault value is False, so dialog server will prompt for
+     * authentication information all the time.
+     */
+    void Authenticate(MAuthenticationDialogObserver& aObserver, TDes& aUsername, TDes& aPassword, TBool aIsReconnect = EFalse);
+
+private:
+    CAuthenticationDialog(TInt aPriority);
+    void ConstructL();
+
+    /** From CActive */
+    virtual void DoCancel();
+    virtual void RunL();
+
+private:
+    MAuthenticationDialogObserver* iObserver;
+    RGenConAgentDialogServer iDlgServ;
+    };
+
+#endif