diff -r 666f914201fb -r 2fe1408b6811 epoc32/include/mw/lbtserver.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/epoc32/include/mw/lbtserver.h Tue Mar 16 16:12:26 2010 +0000 @@ -0,0 +1,87 @@ +/* +* 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 the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members +* which accompanies this distribution, and is available +* at the URL "http://www.symbianfoundation.org/legal/licencesv10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: location triggering server client library +* +*/ + + + +#ifndef LBTSERVER_H +#define LBTSERVER_H + + +#include + +/** + * A handle to Location Triggering Server session. + * + * This is generally the first interface class used by all client applications. + * It is used to make the primary connection to the Location Triggering Server. + * After the primary connection has been established, its handle is passed as a + * parameter of the Open methods of @p RLbt to create a subsession. + * + * @lib lbt.lib + * + * @since S60 5.1 + */ +class RLbtServer : public RSessionBase + { +public: + /** + * Constructor for RLbtServer + */ + IMPORT_C RLbtServer(); + + /** + * Creates a session with the Location Triggering Server. + * This method must be called before any subsession can be opened. + * @see RLbt. + * + * @panic ELbtServerHandleNotClosed Try to connect using an already opened handle. + * + * @return KErrNone, if successful. KErrNotSupported if Location Triggers + * Server is not present in the system. Otherwise one of the other standard + * Symbian error code (for example KErrNoMemory, KErrServerBusy, etc. ) + * is returned. + */ + IMPORT_C TInt Connect(); + + /** + * Closes a session with the Location Triggering Server. + * Before the connection to Location Triggering Server is closed, the + * client application must ensure that all subsessions is closed. + */ + IMPORT_C void Close(); + + /** + * Obtains the client side version number of Location Triggering Server. + * + * @return The client side version number. + */ + IMPORT_C TVersion Version() const; + + /** + * Symbian 2nd phase constructor. + */ + void ConstructL(); + +private: // data + /** + * Unused variable for future expansion. + */ + TAny* iReserved; + }; + + +#endif //LBTSERVER_H