/*
* Copyright (c) 2007-2008 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 "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:  This class implements an active object with callback functionality.
*
*/


#ifndef WLANCBWAITER_H
#define WLANCBWAITER_H

#include <e32base.h>

/**
 * This class implements an active object with callback functionality.
 * 
 * @since S60 v3.2
 */
NONSHARABLE_CLASS( CWlanCbWaiter ) : public CActive
    {

public:

    /**
     * Factory for creating an instance of CWlanTestWaiter.
     *
     * @param aCallback Callback to call when active object completes.
     * @return NULL if unable create an instance, a pointer to the instance otherwise.
     */
    static CWlanCbWaiter* NewL(
        const TCallBack& aCallback );

    /**
     * Destructor.
     */
    virtual ~CWlanCbWaiter();

    /**
     * Issue an asynchronous request.
     *
     * @since S60 v3.2
     */
    void IssueRequest();

    /**
     * Return the status of the request.
     *
     * @return Reference to status of the request.
     */
    TRequestStatus& RequestStatus();

// from base class CActive

    /**
     * From CActive.
     * Called by the active object framework when the request has been completed.
     */
    void RunL();

    /**
     * From CActive.
     * Called by the framework if RunL leaves.
     *
     * @param aError The error code RunL leaved with.
     * @return KErrNone if leave was handled, one of the system-wide error codes otherwise.
     */
    TInt RunError(
        TInt aError );

    /**
     * From CActive.
     * Called by the framework when Cancel() has been called.
     */
    void DoCancel();

private:

    /**
     * Constructor.
     *
     * @param aCallback Callback to call when active object completes.
     */
    CWlanCbWaiter(
        const TCallBack& aCallback );

    /**
     * By default Symbian 2nd phase constructor is private.
     */
    void ConstructL();

private: // data

    /** Function to call once request has been completed. */
    TCallBack iCallback;

    };

#endif // WLANCBWAITER_H