/*

* 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:  Header file for CAccountCreationPlugin

 *

*/

#ifndef ACCOUNTCREATIONPLUGIN_H

#define ACCOUNTCREATIONPLUGIN_H

#include <AiwServiceIfBase.h>

#include <AiwServiceHandler.h>

#include "accountcreationplugin.hrh"

#include "maccountcreationpluginobserver.h"

class MAiwNotifyCallback;

class CAcpProviderListView;

class MAccountCreationPluginObserver;

class CEikonEnv;

/**

 *  CAccountCreationPlugin class

 *  Declarition of CAccountCreationPlugin.

 *

 *  @lib accountcreationplugin.lib

 *  @since S60 v3.2

 */

NONSHARABLE_CLASS( CAccountCreationPlugin ) : public CAiwServiceIfBase,

    public MAccountCreationPluginObserver

    {

public:

    static CAccountCreationPlugin* NewL();

    /**

     * Destructor.

     */

    ~CAccountCreationPlugin();

// from base class CAiwServiceIfBase

    /**

     * From CAiwServiceIfBase.

     * Initialises provider with necessary information from the Service 

     * Handler. This method is called when the consumer makes the attach 

     * operation.

     * Not used but here because of inheritance.

     * 

     * @since S60 v3.2

     * @param aFrameworkCallback Framework provided callback for provider

     *                           to send events to framework. Not used.

     * @param aInterest List of criteria items which invoked the provider.

     *                  Not used.

     */

    void InitialiseL( MAiwNotifyCallback& /*aFrameworkCallback*/,

        const RCriteriaArray& /*aInterest*/ );

    /**

     * From CAiwServiceIfBase.

     * Executes generic service commands included in criteria.

     * 

     * @since S60 v3.2

     * @param aCmdId Command to be executed.

     * @param aInParamList Input parameters, can be an empty list.

     * @param aOutParamList Output parameters, can be an empty list.

     * @param aCmdOptions Options for the command, see KAiwOpt* in 

     *                    AiwCommon.hrh.

     * @param aCallback Callback for asynchronous command handling, 

     *                  parameter checking, etc.

     * @leave KErrArgument Callback is missing when required.

     * @leave KErrNotSupported No provider supports service.

     */

    void HandleServiceCmdL( 

        const TInt& /*aCmdId*/, 

        const CAiwGenericParamList& /*aInParamList*/,

        CAiwGenericParamList& aOutParamList,

        TUint aCmdOptions = 0,

        const MAiwNotifyCallback* aCallback = NULL );

// from base class MAccountCreationPluginObserver

    /**

     * From MAccountCreationPluginObserver.

     * Informs that an AIW event has occurred.

     * 

     * @since S60 v3.2

     * @param aError Error code.

     */

    void NotifyAiwEventL( TInt aError );

    /**

     * From MAccountCreationPluginObserver.

     * Informs that sis file is downloaded.

     * 

     * @since S60 v5.0

     * @param aFileName sis file name

     */

    void NotifySISDownloaded( TDesC& aFileName );

private:

    CAccountCreationPlugin();

    void ConstructL();

    /**

     * Sends AIW service command when plugin initialization is completed. 

     *

     * @since S60 v3.2

     */ 

    void SendInitializedCallbackL() const;

    /**

     * Sends AIW service command when plugin is stopped its work. 

     *

     * @since S60 v3.2

     */         

    void SendCompletedCallbackL() const;

    /**

     * Sends AIW service command when plugin error is reached.

     *

     * @since S60 v3.2 

     */ 

    void SendErrorCallbackL() const;

    /**

     * Compares AIW service command connected uid to our plugin uid.

     *

     * @since S60 v3.2

     * @param aOutParamList AIW service command parameters.

     * @return ETrue if UID's matched, EFalse if not.

     */

    TBool CompareUids( const CAiwGenericParamList& aOutParamList ) const;

    /**

     * Launches ACP UI. 

     *

     * @since S60 v3.2

     */ 

    void LaunchPluginUiL();

private: // data

    /**

     * Resource file offset.

     */

    TInt iResourceOffset;

    /**

     * Handle to AIW Service Handler.

     * Own.

     */

    CAiwServiceHandler* iServiceHandler;

    /**

     * Handle to AIW callback notifier.

     * Not own.

     */

    const MAiwNotifyCallback* iNotifyCallback;

    /**

     * Handle to provider list view.

     * Not own.

     */

    CAcpProviderListView* iProviderListView;

    /**

     * CEikonEnv.

     * Own.

     */

    CEikonEnv* iEikEnv;

    /**

     * Boolean indicating if CSC has been started from active idle

     */ 

    TBool iLaunchedFromAI;    

    };  

#endif  // ACCOUNTCREATIONPLUGIN_H

// End of file.