--- a/epoc32/include/mw/proengfactory.h	Tue Nov 24 13:55:44 2009 +0000
+++ b/epoc32/include/mw/proengfactory.h	Tue Mar 16 16:12:26 2010 +0000
@@ -1,1 +1,126 @@
-proengfactory.h
+/*
+* Copyright (c) 2002-2004 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
+* which accompanies this distribution, and is available
+* at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description: Factory for Profiles Engine Wrapper.
+*
+*/
+
+
+
+#ifndef PROENGFACTORY_H
+#define PROENGFACTORY_H
+
+//  INCLUDES
+#include <e32def.h>
+
+// FORWARD DECLARATIONS
+class RFs;
+class MProEngEngine;
+class MProEngAlertToneSeeker;
+class MProEngNotifyHandler;
+
+// CLASS DECLARATION
+
+/**
+*  Factory for Profiles Engine Wrapper.
+*  You can create new instances of Profiles Engines, Notification Handlers and
+*  Alert Tone Seekers by using this factory.<br><br>
+*  Example:
+*  @code
+*  // Create a new instance of Profiles Engine:
+*  MProEngEngine* engine =
+*      ProEngFactory::NewEngineLC();
+*
+*  // Create a new instance of Notification Handler:
+*  MProEngNotifyHandler* notifyHandler =
+*      ProEngFactory::NewNotifyHandlerL();
+*
+*  // Create a new instance of Alert Tone Seeker:
+*  MProEngAlertToneSeeker* toneSeeker =
+*      ProEngFactory::NewAlertToneSeekerL();
+*  @endcode
+*
+*  @lib ProfileEngine.lib
+*  @since Series 60 3.1
+*/
+class ProEngFactory
+    {
+    public: // New functions
+
+        /**
+        * Create a new instance of Profiles Engine.
+        * @since Series 60 3.1
+        * @return New instance of Profiles Engine.
+        *         Ownership is transferred to the client application.
+        */
+        IMPORT_C static MProEngEngine* NewEngineL();
+
+        /**
+        * Create a new instance of Profiles Engine. The created object is
+        * pushed into the cleanup stack.
+        * @since Series 60 3.1
+        * @return New instance of Profiles Engine.
+        *         Ownership is transferred to the client application.
+        */
+        IMPORT_C static MProEngEngine* NewEngineLC();
+
+        /**
+        * Create a new instance of Profiles Engine.
+        * @since Series 60 3.1
+        * @param aFs A reference to an open file server session. aFs must
+        *        remain connected for the lifetime of the returned object.
+        * @return New instance of Profiles Engine.
+        *         Ownership is transferred to the client application.
+        */
+        IMPORT_C static MProEngEngine* NewEngineL( RFs& aFs );
+
+        /**
+        * Create a new instance of Profiles Engine. The created object is
+        * pushed into the cleanup stack.
+        * @since Series 60 3.1
+        * @param aFs A reference to an open file server session. aFs must
+        *        remain connected for the lifetime of the returned object.
+        * @return New instance of Profiles Engine.
+        *         Ownership is transferred to the client application.
+        */
+        IMPORT_C static MProEngEngine* NewEngineLC( RFs& aFs );
+
+        /**
+        * Create a new instance of Profiles Notification Handler.
+        * @since Series 60 3.1
+        * @return New instance of Notification Handler.
+        *         Ownership is transferred to the client application.
+        */
+        IMPORT_C static MProEngNotifyHandler* NewNotifyHandlerL();
+
+        /**
+        * Create a new instance of Profiles Alert Tone Seeker.
+        * @since Series 60 3.1
+        * @return New instance of Alert Tone Seeker.
+        *         Ownership is transferred to the client application.
+        */
+        IMPORT_C static MProEngAlertToneSeeker* NewAlertToneSeekerL();
+
+    private:
+
+        // Prohibit C++ default constructor.
+        ProEngFactory();
+        // Prohibit Destructor.
+        ~ProEngFactory();
+
+    };
+
+#endif      // PROENGFACTORY_H
+
+// End of File
+