diff -r 000000000000 -r 164170e6151a wim/WimServer/inc/WimSecurityDlgHandler.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/wim/WimServer/inc/WimSecurityDlgHandler.h Tue Jan 26 15:20:08 2010 +0200 @@ -0,0 +1,205 @@ +/* +* Copyright (c) 2003 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: Wrapper class for security dialog management +* +*/ + + + +#ifndef CWIMSECURITYDLGHANDLER_H +#define CWIMSECURITYDLGHANDLER_H + +// INCLUDES +#include +#include // Symbian security dialog interface +#include +//#include + +// CONSTANTS +_LIT( KWimSecDlgsDllName, "CTSecDlgs.dll" ); // Security dialogs DLL + +// CLASS DECLARATION + +/** +* Wrapper for security dialog management +* +* @since Series60 2.6 +*/ +class CWimSecurityDlgHandler : public CBase + { + public: // Constructors and destructor + + /** + * Two-phased constructor. + */ + static CWimSecurityDlgHandler* NewL(); + + /** + * Destructor. + */ + virtual ~CWimSecurityDlgHandler(); + + public: // New functions + + /** + * Shows a security dialog to enable/disable PIN query. + * @param aEnable TRUE = enable query, FALSE = disable query. + * @param aRetry is it first time or retry. + * @param aPINParams PIN parameters. + * @param aPINValue returned PIN value. + * @param aStatus Status of request. + * @return void + */ + void EnablePIN( TBool aEnable, + TBool aRetry, + const TPINParams& aPINParams, + TPINValue& aPINValue, + TRequestStatus& aStatus ); + + + /** + * Shows a security dialog for changing PIN value. + * @param aRetry Is it first time or retry? + * @param aPINParams PIN parameters. + * @param aOldPINValue old PIN to be chanced. + * @param aNewPINValue New PIN to set up. + * @param aStatus Status of request. + * @return void + */ + void ChangePINValue( TBool aRetry, + const TPINParams& aPINParams, + TPINValue& aOldPINValue, + TPINValue& aNewPINValue, + TRequestStatus& aStatus ); + + /** + * Shows the note about blocked PIN to the user. + * @param aPINParams PIN parameters. + * @param aStatus Status of request. + * @return void + */ + void ShowPINBlocked( const TPINParams& aPINParams, + TRequestStatus& aStatus ); + + /** + * Shows the note about total blocked PIN to the user. + * @param aPINParams PIN parameters. + * @param aStatus Status of request. + * @return void + */ + void ShowPINTotalBlocked( const TPINParams& aPINParams, + TRequestStatus& aStatus ); + /** + * Shows the note about card removing to the user. + * @param aStatus Status of request. + * @return void + */ + void ShowCardRemoved( TRequestStatus& aStatus ); + + /** + * Shows a security dialog for fetching PIN and PUK + * values for unblocking blocked PIN. + * @param aRetry is it first time or retry. + * @param aBlockedPINParams Blocked PIN parameters. + * @param aUnblockingPINParams Unblocking PIN parameters. + * @param aUnblockingPINValue Unblocking PIN value. + * @param aNewPINValue New PIN to set up. + * @param aStatus Status of request. + * @return void + */ + void UnblockPIN( TBool aRetry, + const TPINParams& aBlockedPINParams, + const TPINParams& aUnblockingPINParams, + TPINValue& aUnblockingPINValue, + TPINValue& aNewPINValue, + TRequestStatus& aStatus ); + + /** + * Shows a security dialog for asking user to enter PIN code. + * @param aRetry is it first time or retry. + * @param aPINParams PIN parameters. + * @param aPINValue PIN value to be query. + * @param aStatus Status of request. + * @return void + */ + void EnterPIN( TBool aRetry, + const TPINParams& aPINParams, + TPINValue& aPINValue, + TRequestStatus& aStatus ); + + /** + * Close the ongoing dialog + * @param + * @return void + */ + void Cancel(); + + private: + + /** + * C++ default constructor. + */ + CWimSecurityDlgHandler(); + + /** + * By default Symbian 2nd phase constructor is private. + */ + void ConstructL(); + + + /** + * Load and get new instance of security dialog. Completes status + * if call to DoLoadSecurityDialogL() leaves (Dll load fails). + * @return Error code (KErrNone means dialog loaded succesfully) + * If something else than KErrNone status is completed with same error. + */ + TInt LoadSecurityDialog( TRequestStatus& aStatus ); + + /** + * Load and get new instance of PKI dialog. Completes status + * if call to DoLoadPKIDialogL() leaves (Dll load fails). + * @return Error code (KErrNone means dialog loaded succesfully) + * If something else than KErrNone status is completed with same error. + */ + TInt LoadPKIDialog( TRequestStatus& aStatus ); + + /** + * Load and get new instance of security dialog. Leaves if load fails. + * Leave is trapped in LoadSecurityDialog(). + * @return void + */ + void DoLoadSecurityDialogL(); + + /** + * Load and get new instance of PKI dialog. Leaves if load fails. + * Leave is trapped in LoadPKIDialog(). + * @return void + */ + void DoLoadPKIDialogL(); + + private: // Data + // Pointer to security dialog class. Owned. + MSecurityDialog* iSecurityDlg; + + //Pointer to PKI dialog class Owned + //MPKIDialog* iPKIDlg; + + // Pointer to RLibrary object. Owned. + RLibrary iLibrary; + + }; + +#endif // CWIMSECURITYDLGHANDLER_H + +// End of File