/*

* Copyright (c) 2005-2008 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:  Network registration status monitor.

*

*/

#ifndef CSATNETWORKREGSTATUSMONITOR_H

#define CSATNETWORKREGSTATUSMONITOR_H

#include <e32base.h>

#include <e32svr.h>

#include <satcs.h>

#include "msatmultimodeapi.h"

/**

 *  Network registration status monitor

 *

 *  Initiates asynchronous operation to get current network registration

 *  status. After it has been got, initiates monitor change of its value.

 *

 *  @lib SystemState

 *  @since S60 v3.1

 */

class CSatNetworkRegStatusMonitor : public CActive

    {

public:

    static CSatNetworkRegStatusMonitor* NewL( MSatMultiModeApi& aPhone );

    virtual ~CSatNetworkRegStatusMonitor();

    /**

     * Activate network registration status monitor.

     */

    void Start();

    /**

     * Fetch current network registration status.

     * On error returns ERegistrationUnknown.

     *

     * @return Current network registration status.

     */

    RMobilePhone::TMobilePhoneRegistrationStatus CurrentValue();

protected:

    /**

     * From CActive

     * Implements cancellation of an outstanding request.

     */

    void DoCancel();

    /**

     * From CActive

     * Handles an active object's request completion event.

     */

    void RunL();

private:

    CSatNetworkRegStatusMonitor( MSatMultiModeApi& aPhone );

private: // data

    /**

     * Current value of network registration status.

     */

    RMobilePhone::TMobilePhoneRegistrationStatus iRegistrationStatus;

    /**

     * iRegistrationStatus first value has not yet been got

     * after starting this monitor.

     */

    TBool iWaitingRegistrationStatus;

    /**

     * Blocker for synchronous requests.

     */

    CActiveSchedulerWait iWait;

    /**

     * Phone instance.

     * Not own.

     */

    MSatMultiModeApi& iPhone;

    };

#endif // CSATNETWORKREGSTATUSMONITOR_H