realtimenetprots/sipfw/ProfileAgent/Client/Api/sipconcreteprofileobserver.h
author Petteri Saari <petteri.saari@digia.com>
Thu, 02 Dec 2010 15:23:48 +0200
branchMSRP_FrameWork
changeset 60 7634585a4347
parent 0 307788aac0a8
permissions -rw-r--r--
This release addresses the following: - Multiple concurrent file transfer bug fixes. i.e. one device is concurrently receiving multiple files from multiple devices

/*
* Copyright (c) 2003-2009 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:
* Name        : sipconcreteprofileobserver.h
* Part of     : SIP Profile Client
* Interface   : private
* The observer class that must be implemented by users of 
* CSIPConcreteProfile
* Version     : 1.0
*
*/



#ifndef MSIPCONCRETEPROFILEOBSERVER_H
#define MSIPCONCRETEPROFILEOBSERVER_H

//  INCLUDES

#include <e32base.h>

// FORWARD DECLARATIONS


// CLASS DECLARATION
/**
* @publishedAll
* @released
*
* Observer class to be implemented by users of CSIPConcreteProfile
* It provides event notifications related to profiles.
*/
class MSIPConcreteProfileObserver
    {
    public:

        /**
        * SIP profile registration status changed event
        * Event is send to those observers, who have the
        * corresponding profile instantiated.
        * @param aProfileId id of profile which registration 
        *        status has been changed.
        * @param aStatus new status of the profile
        * @param aStatusId id related to registration
        */
        virtual void RegistrationStatusChangedL(
            TUint32 aProfileId, 
            TInt aStatus,
            TUint32 aStatusId) = 0;

        /** 
        * SIP profile creation event.
        * Event is send to all observers.
        * @param aProfileId id of new SIP Profile
        */
        virtual void AddedL(TUint32 aProfileId) = 0;

        /**
        * SIP profile destruction event.
        * Event is send to those observers, who have the
        * corresponding profile instantiated.
        * @param aProfileId id of profile which was destroyed
        */        
        virtual void RemovedL(TUint32 aProfileId) = 0;

        /** 
        * SIP profile information update event
        * Event is send to those observers, who have the
        * corresponding profile instantiated.
        * @param aProfileId id of updated SIP Profile
        * @param aSize size of updated SIP Profile
        */
        virtual void UpdatedL(TUint32 aProfileId, TUint aSize) = 0;

        /**
        * An asynchronous error has occurred related to SIP profile
        * Event is send to those observers, who have the
        * corresponding profile instantiated.
        * @param aProfileId the id of failed profile 
        * @param aStatus status indicating if error occurred
        *          during registering (ERegistrationInProgress)
        *          or deregistering (EUnregistrationInProgress)
        * @param aError a error code
        */
        virtual void ErrorOccurredL(
            TUint32 aProfileId,
            TInt aStatus,
            TInt aError) = 0;
    };

#endif // MSIPCONCRETEPROFILEOBSERVER_H