diff -r 0ba996a9b75d -r 613943a21004 bluetoothengine/bteng/btengconnman/inc/btengpairinghandler.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/bluetoothengine/bteng/btengconnman/inc/btengpairinghandler.h Tue Aug 31 15:25:10 2010 +0300 @@ -0,0 +1,155 @@ +/* +* Copyright (c) 2010 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: Bluetooth Engine API for connection management functionality. +* +*/ + +#ifndef BTENGPAIRINGHANDLER_H +#define BTENGPAIRINGHANDLER_H + +#include +#include + +#include "btengactive.h" + +class CBTEngConnMan; +class MBTEngConnObserver; + + +/** + * ?one_line_short_description + * + * ?more_complete_description + * + * @lib ?library + * @since S60 v3.2 + */ +NONSHARABLE_CLASS( CBTEngPairingHandler ) : public CBase, public MBTEngActiveObserver + { + +public: + + /** + * Two-phase constructor + */ + static CBTEngPairingHandler* NewL( MBTEngConnObserver* aObserver, + CBTEngConnMan* aParent ); + + /** + * Destructor + */ + virtual ~CBTEngPairingHandler(); + + /** + * ?description + * + * @since S60 v3.2 + * @param ?arg1 ?description + * @param ?arg2 ?description + * @return ?description + */ + void StartPairingL( const TBTDevAddr& aAddr, TBTDeviceClass& aDeviceClass ); + + /** + * ?description + * + * @since S60 v3.2 + * @param ?arg1 ?description + * @param ?arg2 ?description + * @return ?description + */ + void CancelPairing(); + +// from base class MBTEngActiveObserver + + /** + * From MBTEngActiveObserver. + * ?description + * + * @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 ); + + /** + * From MBTEngActiveObserver. + * ?description + * + * @since S60 v3.2 + * @param ?arg1 ?description + */ + virtual void HandleError( CBTEngActive* aActive, + TInt aError ); + +private: + + /** + * C++ default constructor + */ + CBTEngPairingHandler( MBTEngConnObserver* aObserver, + CBTEngConnMan* aParent ); + + /** + * Symbian 2nd-phase constructor + */ + void ConstructL(); + +private: // data + + /** + * the address of the remote device to be paired. + */ + TBTDevAddrPckgBuf iAddr; + + /** + * the class of device value of the remote device to be paired. + */ + TBTDeviceClass iCod; + + /** + * the session to notifier which handles the actual pairing operation. + * Own. + */ + RBTNotifier iBtNotifier; + + /** + * Active object for pairing request + * Own. + */ + CBTEngActive* iActive; + + /** + * the observer that receives the result of pairing operation. + * Not own. + */ + MBTEngConnObserver* iObserver; + + /** + * ?description_of_pointer_member + * Not own. + */ + CBTEngConnMan* iParent; + + }; + + +#endif // BTENGPAIRINGHANDLER_H