/*

* Copyright (c) 2006 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:  Converts asynchronous operation to synchronous

*

*/

#ifndef CPHCNTASYNCTOSYNC_H

#define CPHCNTASYNCTOSYNC_H

#include <e32base.h>

/**

 *  Converts asynchronous operation to synchronous

 *

 *  @lib PhoneCntFinder

 *  @since S60 v3.1

 */

NONSHARABLE_CLASS( CPhCntAsyncToSync ) : public CBase

    {

protected:

    /**

     * Converts asynchronous call from DoMakeAsyncRequestL to synchronous. 

     * Derived class has to implement the DoMakeAsyncRequestL method and make

     * asynchronous call from there.

     *

     * @since S60 v3.1

     */

    TInt MakeAsyncRequest();

    /**

     * Indication that asynchronous call from DoMakeAsyncRequestL has 

     * completed. Derived class has to call this method, 

     * when the asynchronous request completes.

     *

     * @since S60 v3.1

     * @param Error code of the response.

     */

    virtual void ResponseReceived( TInt aErrorCode );

    /**

     * Checks if there are pending asynchronous requests available.

     *

     * @since S60 v5.0

     */

    TBool IsActive();

    CPhCntAsyncToSync();

    void BaseConstructL();

    virtual ~CPhCntAsyncToSync();

    /**

     * Template method, which derived class has to implement. This is the

     * place to make the asynchronous call, which is converted to synchronous.

     *

     * @since S60 v3.1

     */

    virtual void DoMakeAsyncRequestL() = 0;

private: // data

    /**

     * To make asynchronous operation synchronous

     * Own.

     */

    CActiveSchedulerWait* iWait;

    /**

     * Indication of response received from the async request.

     */

    TBool iResponseReceived;

    /**

     * Error code from response.

     */

    TInt iResponseError;

    };

#endif // CPHCNTASYNCTOSYNC_H