/*
* 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:  Helper class declaration for performing device discovery.
*
*/



#ifndef BTENGDEVICESEARCH_H
#define BTENGDEVICESEARCH_H


#include <btnotif.h>
#include <bt_sock.h>
#include "btengactive.h"

class MBTEngSdpResultReceiver;

/**
 *  Class CBTEngDeviceSearch
 *
 *  ?more_complete_description
 *
 *  @lib ?library
 *  @since S60 v3.2
 */
NONSHARABLE_CLASS( CBTEngDeviceSearch ) : public CBase, 
                                          public MBTEngActiveObserver
    {

public:

    /**
     * Two-phase constructor
     */
    static CBTEngDeviceSearch* NewL();

    /**
     * Destructor
     */
    virtual ~CBTEngDeviceSearch();

    /**
     * ?description
     *
     * @since S60 v3.2
     * @param ?arg1 ?description
     * @param ?arg2 ?description
     * @return ?description
     */
    TInt StartSearch( CBTDevice* aDevice, 
            TNameEntry* aNameEntry,
            const TBTDeviceClass& aDeviceClass, 
            MBTEngSdpResultReceiver* aNotifier );

    /**
     * ?description
     *
     * @since S60 v3.2
     * @param ?arg1 ?description
     * @param ?arg2 ?description
     * @return ?description
     */
    void CancelSearch();

    TInt GetEirServiceUUIDs( const TBTDevAddr& aAddr, 
            TNameEntry* aNameEntry,
                MBTEngSdpResultReceiver* aNotifier);    
    
    void CancelGetEirServiceUUIDs();
    
// from base class MBTEngActiveObserver

    /**
     * From MBTEngActiveObserver.
     * Callback to notify that an outstanding request has completed.
     *
     * @since S60 v3.2
     * @param ?arg1 ?description
     */
    virtual void RequestCompletedL( CBTEngActive* aActive, 
                                     TInt aStatus );
    
    /**
     * Callback for handling cancelation of an outstanding request.
     *
     * @param aId The ID that identifies the outstanding request.
     */
    virtual void CancelRequest( TInt aRequestId );
    
    /**
     * Callback to notify that an error has occurred in RunL.
     *
     * @since S60 v3.2
     * @param ?arg1 ?description
     */
    virtual void HandleError( CBTEngActive* aActive, TInt aError );

private:

    /**
     * C++ default constructor
     */
    CBTEngDeviceSearch();

    /**
     * Symbian 2nd-phase constructor
     */
    void ConstructL();
    
    TInt DoGetDeviceEir(const TBTDevAddr& aAddr );
    
    void HandleDeviceSelectionResultL(TInt aErr);
    
    void HandleDeviceEirDataResult(TInt aErr);
    
    /**
     * Notifies the caller of the search result.
     */
    void NotifyClient(TInt aErr);

private:
    enum TClientRequest
        {
        EDeviceSearch,
        EGetDeviceEir
        };
    
private: // data

    /**
     * Hanlde to the search notifier.
     */
    RNotifier iNotifier;

    /**
     * Selection parameters package buffer.
     */
    TBTDeviceSelectionParamsPckg iSelectionPckg;
    
    /**
     * Response parameters package buffer.
     */
    TBTDeviceResponseParamsPckg iResponsePckg;
    
    /**
     * Our actual active object.
     * Own.
     */
    CBTEngActive* iActive;
    
    /**
     * Socket server for Host Resolver.
     * Own.
     */
    RSocketServ         iSocketServer; 
    
    /**
     * Hose Resolver to get cached EIR.
     * Own.
     */    
    RHostResolver       iHostResolver;
    
    /**
     * used for getting cached EIR.
     */
    TInquirySockAddr    iInquirySockAddr;
    
    /**
     * Client's object to store the results.
     * Not own.
     */
    CBTDevice* iDevice;
    
    /**
     * Client's object to store EIR data.
     * Not own.
     */
    TNameEntry* iNameEntry;

    /**
     * Reference to receiver of results.
     * Not own.
     */
    MBTEngSdpResultReceiver* iResultNotifier;

    TClientRequest iClientReq;
    
    };


#endif // BTENGDEVICESEARCH