diff -r 000000000000 -r 094583676ce7 PECengine/StorageManager2/ClientSrc/CPEngSIDContainer.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/PECengine/StorageManager2/ClientSrc/CPEngSIDContainer.h Thu Dec 17 08:41:52 2009 +0200 @@ -0,0 +1,148 @@ +/* +* Copyright (c) 2002 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: Storage Id container +* +*/ + + + +#ifndef __CPENGSIDCONTAINER_H__ +#define __CPENGSIDCONTAINER_H__ + +// INCLUDES +#include +#include "MPEngSIDContainer.h" + +// FORWARD DECLARATIONS +class MPEngSIDChangeObserver; + +/** + * One storage Id container + * It hold reference to the all observers + * which are observing this storage Id + * + * @lib PEngStorMan2.dll + * @since 3.0 + */ +NONSHARABLE_CLASS( CPEngSIdContainer ): + public CBase, + public MPEngSIdContainer + { +public: // Constructors and destructor + + /** + * Two-phased constructor. + */ + static CPEngSIdContainer* NewLC( const TDesC& aSId ); + + /** + * Destructor. + */ + virtual ~CPEngSIdContainer(); + +public: // New functions of MPEngSIDContainer + + /** + * Returns engaged SId + * More info in + * @since 3.0 + */ + const TDesC& SId() const; + + /** + * Add Observer container to the container + * More info in + * @since 3.0 + */ + TInt AddObserverContainer( + const CPEngObserverContainer* aObserver ); + + /** + * Remove Observer from the container + * More info in + * @since 3.0 + */ + void RemoveObserverContainer( + const CPEngObserverContainer* aObserver ); + +public: // New functions + + /** + * Notify change of the storage Id to the observers + * + * @since 3.0 + */ + void NotifySIdChangeL(); + + /** + * SId published to the Server + * + * @since 3.0 + * @return ETrue if it was published + */ + TBool SIdPublished() const; + + /** + * Set SId as published to the Server + * + * @since 3.0 + * @return ETrue if yes + */ + void SetSIdPublished(); + + /** + * Observers count + * + * @since 3.0 + * @return count of observers + */ + TInt ObserverCount() const; + + /** + * Allocated free slots in array + * + * @since 3.0 + * @param count of new slots to be still allocated + * @param aDone number already allocated slots + * @return KErrNone if OK otherwise wise error code + */ + TInt AllocateSlots( TInt aCount, TInt aDone = 0 ); + +private: + + /** + * C++ default constructor. + */ + CPEngSIdContainer(); + + /** + * By default Symbian 2nd phase constructor is private. + */ + void ConstructL( const TDesC& aSId ); + +private: // Data + /// OWN: Store ID owned + HBufC* iSId; + + /// REF: Observer Container array + RPointerArray iObservers; + + + /// Flag is SID was published to the server + TBool iPublished; + }; + +#endif // __CPENGSIDCONTAINER_H__ + +// End of File