diff -r 000000000000 -r 094583676ce7 inc/CPEngReactAuthStore.h
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/inc/CPEngReactAuthStore.h	Thu Dec 17 08:41:52 2009 +0200
@@ -0,0 +1,221 @@
+/*
+* 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:  Store API to retrieve reactive authorization models.
+*
+*/
+
+#ifndef __CPENGREACTAUTHSTORE_H__
+#define __CPENGREACTAUTHSTORE_H__
+
+// INCLUDES
+#include <E32Base.h>
+
+
+//FORWARD DECLARATIONS
+class CPEngReactAuthStoreImp;
+class CPEngNWSessionSlotID2;
+class MPEngAuthorizationRequest;
+class MPEngAuthorizationStatus;
+class MPEngAuthorizationRespond;
+
+
+
+/**
+ * Store API to retrieve and manage reactive authorizations.
+ *
+ * With this API clients can access and manage presence
+ * reactive authorizations.
+ *
+ * @lib PEngManager2.lib
+ * @since 3.0
+ */
+class CPEngReactAuthStore : public CBase
+    {
+        //-----------------------------------------------------------------------
+    public: /* Construction */
+
+        /**
+         * Instantiates CPEngReactAuthStore object.
+         *
+         * Instantiates CPEngReactAuthStore object and connects it to
+         * identified Presence Engine side NWSessionSlot. NWSessionSlot
+         * must be a valid, existing slot.
+         *
+         * Errors:
+         *  - Requested NWSessionSlot not found: KErrNotFound
+         *  - Given NWSessionSlotID malformed: KErrArgument
+         *
+         * @param aNWSessionSlotID The session slot ID to identify the
+         * session slot.
+         * @param aPriority The priority for Presence Engine client side active
+         * objects. These active objects are used when asynchronously delivering
+         * events to observers or maintaining Presence Cache state.
+         *
+         * @return New CPEngReactAuthStore instance.
+         */
+        IMPORT_C static CPEngReactAuthStore* NewL(
+            const CPEngNWSessionSlotID2& aNWSessionSlotID,
+            TInt aPriority = CActive::EPriorityStandard );
+
+        IMPORT_C static CPEngReactAuthStore* NewLC(
+            const CPEngNWSessionSlotID2& aNWSessionSlotID,
+            TInt aPriority = CActive::EPriorityStandard );
+
+
+        /**
+         * Destructor.
+         * Virtual by CBase.
+         */
+        ~CPEngReactAuthStore();
+
+
+
+    private:
+
+        CPEngReactAuthStore();
+
+
+        //-----------------------------------------------------------------------
+    public: /* Reactive authorization requests */
+
+
+        /**
+         * Count of all authorization requests.
+         *
+         * @since 3.0
+         * @return Count of all authorization requests.
+         */
+        IMPORT_C TInt AuthorizationReqCount() const;
+
+
+        /**
+         * Gets authorization request.
+         *
+         * @since 3.0
+         * @param aIndex Index of the authorization request.
+         * @return The authorization request.
+         */
+        IMPORT_C MPEngAuthorizationRequest& AuthorizationReq( TInt aIndex );
+
+
+        /**
+         * Count of pending authorizations requests.
+         * This also includes authorizations which were
+         * already responded, but server reissued them again.
+         *
+         * @since 3.0
+         * @return Count of pending authorization requests.
+         */
+        IMPORT_C TInt PendingAuthorizationReqCount()  const;
+
+
+        /**
+         * Gets pending authorization request.
+         *
+         * @since 3.0
+         * @param aIndex Index of the pending authorization request.
+         * @return The pending authorization request.
+         */
+        IMPORT_C MPEngAuthorizationRequest& PendingAuthorizationReq( TInt aIndex );
+
+
+
+        //-----------------------------------------------------------------------
+    public: /* Reactive authorization responds */
+
+
+        /**
+         * Count of responded authorizations.
+         *
+         * @since 3.0
+         * @return Count of responded authorizations.
+         */
+        IMPORT_C TInt RespondedAuthorizationCount() const;
+
+
+        /**
+         * Responded authorizations.
+         *
+         * @since 3.0
+         * @param aIndex Index of the responded authorization.
+         * @return The responded authorization.
+         */
+        IMPORT_C const MPEngAuthorizationStatus& RespondedAuthorization( TInt aIndex ) const;
+
+
+        /**
+         * Count of server denied authorizations.
+         *
+         * @since 3.0
+         * @return Count of server denied authorizations.
+         */
+        IMPORT_C TInt ServerDeniedAuthorizationCount() const;
+
+
+        /**
+         * Server denied authorization.
+         *
+         * @since 3.0
+         * @param aIndex Index of server denied authorization.
+         * @return The served denied authorization.
+         */
+        IMPORT_C const MPEngAuthorizationStatus& ServerDeniedAuthorization( TInt aIndex ) const;
+
+
+
+        //-----------------------------------------------------------------------
+    public: /* Reactive authorization responds */
+
+        /**
+         * Gets a authorization respond for editing.
+         * Ownership of authorization respond is transferred
+         * to caller.
+         *
+         * Authorization respond object buffers individual
+         * authorization responses for publishing them at once.
+         * Respond object holds also edit lock,
+         * so two client cannot edit authorization responses
+         * at the same time.
+         *
+         * Lock and buffered responses are released
+         * either by the updating of the reactive authorization
+         * responses to network or by deleting the
+         * respond object.
+         *
+         * @param aRespond The authorization respond object.
+         *        If operation succeeds, returns respond object
+         *        ownership to caller.
+         * @return Status code from authorization respond creation:
+         *        - KErrNone if creation succeeds.
+         *        - KErrLocked if authorization respond is already locked.
+         *        - Else one of system wide error codes.
+         */
+        IMPORT_C TInt GetAndLockAuthorizationRespond(
+            MPEngAuthorizationRespond*& aRespond );
+
+
+
+        //-----------------------------------------------------------------------
+    private: /* Data */
+
+
+        //OWN: Implementation
+        CPEngReactAuthStoreImp*     iImp;
+    };
+
+
+
+#endif      //  __CPENGREACTAUTHSTORE_H__
+
+//End of file