/*
* Copyright (c) 2004 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:  Reactive authorization status interface.
*
*/

#ifndef __MPENGAUTHORIZATIONSTATUS_H
#define __MPENGAUTHORIZATIONSTATUS_H


//  INCLUDES
#include <E32Std.h>


// FORWARD DECLARATIONS
class MPEngAuthorizationStatusExt;



// CLASS DECLARATION
/**
 * Interface for reactive authorization status.
 *
 * @since 3.0
 */
class MPEngAuthorizationStatus
    {
    public: // Authorization statuses

        /**
         * Reactive authorization statuses.
         *
         * @since 3.0
         */
        enum TPEngAuthorizationStatusType
            {
            //Authorization status is undefined
            EPEngAuthUndefined      = 0x00000,

            //Authorization was accepted
            EPEngAuthAccepted       = 0x00001,

            //Authorization was denied
            EPEngAuthDenied         = 0x00002,
            };


    public: // Access to authorization status details

        /**
         * Identification of user.
         *
         * Gets identification of user.
         *
         * @since 3.0
         * @return Id of the requesting user.
         */
        virtual const TDesC& UserId() const = 0;


        /**
         * Status of the authorization.
         *
         * Gets the status of authorization.
         *
         * @since 3.0
         * @return Status of of the authorization.
         */
        virtual TInt AuthorizationStatus() const = 0;


        /**
         * List of authorized attributes
         *
         * Gets the list of authorized attributes.
         *
         * @since 3.0
         * @return List of authorized attributes.
         */
        virtual const RArray<TUint32>& AuthorizedAttributes() const = 0;



    private: //Extensions interfaces

        /**
         * Reactive authorization status extension interface.
         *
         * @since 3.0
         * @return Reactive authorization status extension.
         */
        virtual MPEngAuthorizationStatusExt* Extension() = 0;
        virtual const MPEngAuthorizationStatusExt* Extension() const = 0;


    protected:  //Destructor

        /**
         * Virtual inline destructor.
         * Protected destructor to prohibits deletion
         * through the interface.
         */
        virtual ~MPEngAuthorizationStatus() {};

    };
#endif      //  __MPENGAUTHORIZATIONSTATUS_H


//  End of File