/*
* 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:  The declaration for Service class of Location Settings UI 
*                Server
*
*/


#ifndef C_LOCSETTINGSUISERVICE_H
#define C_LOCSETTINGSUISERVICE_H

#include <AknServerApp.h>

/**
 *  The service class for Location Settings UI Application Server.
 *
 *  The Service class receives requests from the clients. It
 *  processes these requests to provide the Settings UI Launch
 *  service.
 *
 *  @lib 
 *  @since S60 v3.1
 */
NONSHARABLE_CLASS(CLocSettingsUIService) : public CAknAppServiceBase
    {
public:
    /**
     * Constructor
     */
    CLocSettingsUIService();

    /**
     * Destructor
     */
    virtual ~CLocSettingsUIService();

public:
    /**
     * Override of CAknAppServiceBase
     * This function must base-call CAknAppServiceBase::CreateL()
     *
     * @param None.
     * @return None.
     */
    void CreateL();
    
    /**
     * Override of CAknAppServiceBase
     * This function must base-call CAknAppServiceBase::ServiceL()
     *
     * @param aMessage The client message
     * @return None.
     */
    void ServiceL(const RMessage2& aMessage);

    /**
     * Override of CAknAppServiceBase
     * This function must base-call CAknAppServiceBase::ServiceError()
     *
     * @param aMessage The client message.
     * @param aError The error code to which occured during message servicing
     * @return None.
     */
    void ServiceError(const RMessage2& aMessage,TInt aError);

    /**
     * Override of CApaAppServiceBase
     * This method is called for every request.
     * This method checks whether the client has the neccessary
     * permission to execute this request.
     *
     * @param aMessage The client message.
     * @param aAction The Action to be taken if the security check fails.
     * This is typically a value from TFailureAction.
     * @param aMissing A reference to the list of security attributes missing
     * from the checked process.  The policy server initialises this
     * object to zero (that is a sid of 0, a vid of 0, and no capabilities).
     * If derived implementations wish to take advantage of a list of
     * missing attributes in their implementation of CustomFailureActionL(),
     * then they should set those missing attributes here in
     * CustomSecurityCheckL().
     * @return A value from CPolicyServer::TCustomResult.
     */
	
	CPolicyServer::TCustomResult SecurityCheckL(const RMessage2& aMessage,
	                                            TInt& aAction,
	                                            TSecurityInfo& aMissing);
    
private: // Helper methods
    /**
     * This is a helper method to determine whether the passed parameters are
     * valid or not.
     *
     * @param aSettingsUid The UID value for the settings UI.
     * @param aParams The opaque paramters that are passed from the client
     * to the Settings UI.
     * @return Etrue if the parameters valid. EFalse otherwise.
     */
    TBool IsLaunchParamsValid(      TInt aSettingsUid,
                              const TInt aParams);

private: // data
    /**
     * Boolean to indicate whether a Settings UI has been launched from this
     * session object or not.
     */
    TBool iSettingsUILaunched;
    };

#endif // C_LOCSETTINGSUISERVICE_H