FCL/sf/mw/phonesrv: comparison vmbx/vmbxengine/inc/voicemailboximpl.h

equal deleted inserted replaced

-:d7fc66ccd6fb
+:e44a8c097b15
 /*
-* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
+* Copyright (c) 2009-2010 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".
 /**
 *  Implemets mailbox entry base class functionality
 *
 *  @lib vmbxengine.lib
-*  @since S60 v5.2
 */
 NONSHARABLE_CLASS( CVoiceMailboxImpl ) : public CBase,
 public MVmbxChangeObserver,
 public MVmbxResourceProvider
 {
 public: // New functions
 /**
 * see CVoiceMailbox::GetStoredEntry
 *
-* @since S60 v5.2
 */
 TInt GetStoredEntry( const TVoiceMailboxParams& aParams,
 CVoiceMailboxEntry*& aEntry ) const;
 /**
 * see CVoiceMailbox::SaveEntry
 *
-* @since S60 v5.2
 */
 TInt SaveEntry( const CVoiceMailboxEntry& aEntry );
 /**
 * see CVoiceMailbox::QueryNewEntry
 *
-* @since S60 v5.2
 */
 TInt QueryNewEntry( const TVoiceMailboxParams& aParams,
 CVoiceMailboxEntry*& aEntry );
 /**
 * see CVoiceMailbox::QueryChangeEntry
 *
-* @since S60 v5.2
 */
 TInt QueryChangeEntry( const TVoiceMailboxParams& aParams,
 CVoiceMailboxEntry*& aEntry);
 /**
 * see CVoiceMailbox::QueryVmbxType
 *
-* @since S60 v5.2
 */
 TInt QueryVmbxType( TVoiceMailboxParams& aParams );
 /**
 * see CVoiceMailbox::NotifyVmbxNumberChangeL
 *
-* @since S60 v5.2
 */
 void NotifyVmbxNumberChangeL( MVoiceMailboxObserver& aObserver,
 const TBool aNotifyOnActiveLineOnly );
 /**
 * see CVoiceMailbox::NotifyVmbxNumberChangeCancel
 *
-* @since S60 v5.2
 */
 void NotifyVmbxNumberChangeCancel();
 /**
 * see CVoiceMailbox::CheckConfiguration
 const TInt aFlags );
 /**
 * see CVoiceMailbox::GetServiceIds
 *
-* @since S60 v5.2
 */
 TInt GetServiceIds( RIdArray& aProfileIds );
 /**
 * see CVoiceMailbox::GetVmbxImage
 *
-* @since S60 v5.2
 */
 //CGulIcon* GetVmbxImage( const TVoiceMailboxParams& aParams );
 /**
 * see CVoiceMailbox::GetVmbxImages
 *
-* @since S60 v5.2
 */
 //CArrayPtr<CGulIcon>* GetVmbxImages(
 //                        RArray<TVoiceMailboxParams>& aParams );
 /**
 * see CVoiceMailbox::SaveProvisionedEntry
 *
-* @since S60 v5.2
 */
 TInt SaveProvisionedEntry( const CVoiceMailboxEntry& aEntry );
 public:  // From MVmbxChangeObserver
 /**
 * see MVmbxChangeObserver::SatRefreshL
 *
-* @since S60 v5.2
 */
 void SatRefreshL();
 /**
 * see MVmbxChangeObserver::CenRepChangedL
 *
-* @since S60 v5.2
 */
 void CenRepChangedL( TVmbxCenRepKey aId );
 /**
 * see MVmbxChangeObserver::SimStoreChangedL
 *
-* @since S60 v5.2
 */
 void SimStoreChangedL();
 public:  // From MVmbxChangeObserver
 /**
 * Get Handler of VmbxUiUtilities
 *
-* @since S60 v5.2
 * @return Refereance of MVmbxUiUtilities
 */
 MVmbxUiUtilities& VmbxUiUtilities();
 /**
 * Get Handler of VmbxCenrepHandler
 *
-* @since S60 v5.2
 * @return Refereance of MVmbxCenrepHandler
 */
 MVmbxCenrepHandler& VmbxCenRepHandler();
 CVoiceMailboxImpl();
 /**
 * ConstructL
 *
-* @since S60 v5.2
 */
 void ConstructL();
 /**
 * Retrieves voice mailbox entry for the specified service.
 * Leave - KErrNotFound if no entry available
 *       - KErrArgument when illegal argument
 *       - Other system wide errors.
 *
-* @since S60 v5.2
 * @param in Params Service id and type of the mailbox for which
 *          a number/address should be defined.
 * @param out aEntry If successful, a new result container is
 *  created and ownership passed to the caller.
 */
 *         - KErrArgument When illegal argument.
 *         - KErrNotSupported if not capable or allowed to execute this
 *              for the specified mailbox.
 *         - Other system wide errors.
 *
-* @since S60 v5.2
 * @param in aParams Service id and type of the mailbox for which
 *          a number/address should be defined.
 * @param out aEntry If successful, a new result container is
 *  created and ownership passed to the caller.
 */
 *
 * Some mailbox types may not support saving all arguments.
 * In that case unsupported arguments are ignored.
 * This method may display related UI notes or queries.
 *
-* @since S60 v5.2
 * @param in aEntry The vmbx entry to save.
 */
 void SaveEntryL( const CVoiceMailboxEntry& aEntry );
 /**
 *         - KErrArgument When illegal argument.
 *         - KErrNotSupported if not capable or allowed to execute this
 *              for the specified mailbox.
 *         - Other system wide errors.
 *
-* @since S60 v5.2
 * @param in aParams Service id and type of the mailbox.
 * @param out aEntry If successful, a new result container is
 */
 void QueryChangeEntryL( const TVoiceMailboxParams& aParams,
 CVoiceMailboxEntry*& aEntry);
 *         - KErrNotFound if there is no defined voice number and
 *             user have selected the type to define or the default
 *             type given.
 *         - Other system wide errors.
 *
-* @since S60 v5.2
 * @param out aParams If successful,
 *          contains selected mailbox info.
 */
 void QueryVmbxTypeL( TVoiceMailboxParams& aParams );
 /**
 * Get defined entries via an array
 * Leave with symbian OS error code except KErrNotFound and KErrSupported.
 *
-* @since S60 v5.2
 * @param out aArray array contains the defined entries
 */
 void GetDefinedEntriesL( RPointerArray<CVoiceMailboxEntry>& aArray );
 /**
 * Get defined voice entry via an array
 *  Leave with symbian OS error code except KErrSupported.
 *
-* @since S60 v5.2
 * @param out aArray array contains the defined entries
 */
 void GetDefinedVoiceEntryL(
 RPointerArray<CVoiceMailboxEntry>& aArray );
 /**
 * Get defined video entry via an array
 * Leave with symbian OS error code except KErrNotFound and KErrSupported.
 *
-* @since S60 v5.2
 * @param out ay array contains the defined entries
 */
 void GetDefinedVideoEntryL(
 RPointerArray<CVoiceMailboxEntry>& aArray );
 /**
 * Get defined voip entries via an array
 * Leave with symbian OS error code except KErrNotFound and KErrSupported.
 *
-* @since S60 v5.2
 * @param out aArray array contains the defined entries
 */
 void GetDefinedVoipEntriesL(
 RPointerArray<CVoiceMailboxEntry>& aArray );
 /**
 * Checks the Voice Mailbox how many VoIP service Ids
 * Leave with symbian OS error code
 *
-* @since S60 v5.2
 * @param out aProfileIds
 * @return KErrNone if get service Ids successfully.
 */
 void GetServiceIdsL( RIdArray& aProfileIds );
 * Retrieves an image associated with the specified mailbox,
 * if an image is available.
 * Image can be displayed e.g. in a selection list.
 * Leave with symbian OS error code.
 *
-* @since S60 v5.2
 * @param in aParams Mailbox service id and type for which image is needed.
 * @return aImage New image. Ownership is transferred.
 */
 //CGulIcon* GetVmbxImageL( const TVoiceMailboxParams& aParams );
 * corresponding to the index of the service id in the input
 * array aMailboxServices.
 * NULL array pointer is returned if not a signle icon was retrieved
 * successfully.
 *
-* @since S60 v5.2
 * @param in aParams Mailboxes (id and type) for which an image is needed.
 * @return aImage Icons for the specified mailboxes.
 *          Index of an image in the returned array corresponds to the
 *          index of the service id in the input array.
 *          Array and icon ownerships are transferred to caller.
 /**
 * Notify entry changed
 * Leave with symbian OS error code.
 *
-* @since S60 v5.2
 * @param in aType Type of TVmbxType
 */
 void NotifyChangedL( TVmbxType aType);
 /**
 *         - Other system wide errors.
 *
 * Some mailbox types may not support saving all arguments.
 * In that case unsupported arguments are ignored.
 *
-* @since S60 v5.2
 * @param in aEntry The provisioned vmbx entry to save.
 */
 void SaveProvisionedEntryL( const CVoiceMailboxEntry& aEntry );
+/**
+* Check number provisioned or not
+* Leave if systrm wide errors
+*
+* @param in aParams params of TVoiceMailboxParams
+*/
+void CheckNumberProvisionedL( const TVoiceMailboxParams& aParams );
 protected: // data
 /**
 * Pointer to CVmbxUiUtilities

changeset 19	e44a8c097b15
parent 12	ae8abd0db65c