serviceproviders/sapi_landmarks/landmarksservice/inc/landmarkservice.h
changeset 26 5d0ec8b709be
parent 5 989d2f495d90
equal deleted inserted replaced
23:50974a8b132e 26:5d0ec8b709be
   114 	 * will be imported.
   114 	 * will be imported.
   115 	 */
   115 	 */
   116 	IMPORT_C void ImportL( CPosLmItemIterator*& aIterator,
   116 	IMPORT_C void ImportL( CPosLmItemIterator*& aIterator,
   117 			CPosLandmarkParser& aLandmarkParser,
   117 			CPosLandmarkParser& aLandmarkParser,
   118 			const TDesC& aDatabaseUri = KNullDesC );
   118 			const TDesC& aDatabaseUri = KNullDesC );
       
   119 	IMPORT_C void ImportL( TInt32 aTransactionId,
       
   120 			CPosLandmarkParser& aLandmarkParser,
       
   121 			const TDesC& aDatabaseUri = KNullDesC );
   119 
   122 
   120 	/**
   123 	/**
   121 	 * ExportL.
   124 	 * ExportL.
   122 	 * Export a set of landmarks from the requested database to a file.
   125 	 * Export a set of landmarks from the requested database to a file.
   123 	 * @param aLandmarkEncoder A pointer to a landmark encoder object.
   126 	 * @param aLandmarkEncoder A pointer to a landmark encoder object.
   125 	 * @param aDatabaseUri The URI of the database from which the landmarks will 
   128 	 * @param aDatabaseUri The URI of the database from which the landmarks will 
   126 	 * be exported.
   129 	 * be exported.
   127 	 */
   130 	 */
   128 	IMPORT_C void ExportL( CPosLandmarkEncoder& aLandmarkEncoder,
   131 	IMPORT_C void ExportL( CPosLandmarkEncoder& aLandmarkEncoder,
   129 			const RArray<TPosLmItemId>& aLandmarkIdArray,
   132 			const RArray<TPosLmItemId>& aLandmarkIdArray,
       
   133 			const TDesC& aDatabaseUri = KNullDesC ) const;
       
   134 	
       
   135 	IMPORT_C void ExportL( TInt32 aTransactionId,
       
   136 			CPosLandmarkEncoder& aLandmarkEncoder,
       
   137 			const RArray<TPosLmItemId>& aLandmarkIdArray,
       
   138 			const TDesC& aDestinationFile,
   130 			const TDesC& aDatabaseUri = KNullDesC ) const;
   139 			const TDesC& aDatabaseUri = KNullDesC ) const;
   131 
   140 
   132 	/**
   141 	/**
   133 	 * GetListL.
   142 	 * GetListL.
   134 	 * Gets a list of landmarks/landmark categories from the requested database synchronously.
   143 	 * Gets a list of landmarks/landmark categories from the requested database synchronously.
   172 	 * instance should be added.
   181 	 * instance should be added.
   173 	 */
   182 	 */
   174 	IMPORT_C TPosLmItemId AddItemL( CPosLandmark& aLandmark,
   183 	IMPORT_C TPosLmItemId AddItemL( CPosLandmark& aLandmark,
   175 			const TDesC& aDatabaseUri = KNullDesC );
   184 			const TDesC& aDatabaseUri = KNullDesC );
   176 
   185 
       
   186 	IMPORT_C void AddItemL(TInt32 aTransactionId, CPosLandmark& aLandmark,
       
   187 			const TDesC& aDatabaseUri = KNullDesC);
   177 	/**
   188 	/**
   178 	 * AddItemL.
   189 	 * AddItemL.
   179 	 * Adds a new Landmark category to the given database.
   190 	 * Adds a new Landmark category to the given database.
   180 	 * @param aCategory CPosLandmarkCategory instance to be added to database.
   191 	 * @param aCategory CPosLandmarkCategory instance to be added to database.
   181 	 * @param aDatabaseUri The URI of the database to which CPosLandmarkCategory
   192 	 * @param aDatabaseUri The URI of the database to which CPosLandmarkCategory
   182 	 * instance should be added.
   193 	 * instance should be added.
   183 	 */
   194 	 */
   184 	IMPORT_C TPosLmItemId AddItemL( CPosLandmarkCategory& aCategory,
   195 	IMPORT_C TPosLmItemId AddItemL( CPosLandmarkCategory& aCategory,
   185 			const TDesC& aDatabaseUri = KNullDesC );
   196 			const TDesC& aDatabaseUri = KNullDesC );
   186 
   197 
       
   198 	IMPORT_C void AddItemL(TInt32 aTransactionId,
       
   199 			CPosLandmarkCategory& aCategory, const TDesC& aDatabaseUri =
       
   200 					KNullDesC);
   187 	/**
   201 	/**
   188 	 * AddItemL.
   202 	 * AddItemL.
   189 	 * Adds a new database to terminal.
   203 	 * Adds a new database to terminal.
   190 	 * @param aDatabaseUri The URI of the database to be added to terminal.
   204 	 * @param aDatabaseUri The URI of the database to be added to terminal.
   191 	 */
   205 	 */
   199 	 * instance should be updated.
   213 	 * instance should be updated.
   200 	 */
   214 	 */
   201 	IMPORT_C void UpdateItemL( const CPosLandmark& aLandmark,
   215 	IMPORT_C void UpdateItemL( const CPosLandmark& aLandmark,
   202 			const TDesC& aDatabaseUri = KNullDesC );
   216 			const TDesC& aDatabaseUri = KNullDesC );
   203 
   217 
       
   218 	IMPORT_C void UpdateItemL(TInt32 aTransactionId,
       
   219 			const CPosLandmark& aLandmark, const TDesC& aDatabaseUri =
       
   220 					KNullDesC);
   204 	/**
   221 	/**
   205 	 * UpdateItemL.
   222 	 * UpdateItemL.
   206 	 * Updates an existing Landmark category in the given database.
   223 	 * Updates an existing Landmark category in the given database.
   207 	 * @param aCategory CPosLandmarkCategory instance to be updated in database.
   224 	 * @param aCategory CPosLandmarkCategory instance to be updated in database.
   208 	 * @param aDatabaseUri The URI of the database to which CPosLandmarkCategory 
   225 	 * @param aDatabaseUri The URI of the database to which CPosLandmarkCategory 
   209 	 * instance should be updated.
   226 	 * instance should be updated.
   210 	 */
   227 	 */
   211 	IMPORT_C void UpdateItemL( const CPosLandmarkCategory& aCategory,
   228 	IMPORT_C void UpdateItemL( const CPosLandmarkCategory& aCategory,
   212 			const TDesC& aDatabaseUri = KNullDesC );
   229 			const TDesC& aDatabaseUri = KNullDesC );
   213 
   230 
       
   231 	IMPORT_C void UpdateItemL(TInt32 aTransactionId,
       
   232 			const CPosLandmarkCategory& aCategory, const TDesC& aDatabaseUri =
       
   233 					KNullDesC);
   214 	/**
   234 	/**
   215 	 * UpdateItemL.
   235 	 * UpdateItemL.
   216 	 * Updates existing Database Information.
   236 	 * Updates existing Database Information.
   217 	 * @param aSettings TPosLmDatabaseSettings information to be updated.
   237 	 * @param aSettings TPosLmDatabaseSettings information to be updated.
   218 	 * @param aDatabaseUri The URI of the database to be updated.
   238 	 * @param aDatabaseUri The URI of the database to be updated.
   251 	 * Landmark/Landmark category is to be removed.
   271 	 * Landmark/Landmark category is to be removed.
   252 	 */
   272 	 */
   253 	IMPORT_C void RemoveItemL( TPosLmItemId aItemId, TPosItem aItemIsLandmark,
   273 	IMPORT_C void RemoveItemL( TPosLmItemId aItemId, TPosItem aItemIsLandmark,
   254 			const TDesC& aDatabaseUri = KNullDesC );
   274 			const TDesC& aDatabaseUri = KNullDesC );
   255 
   275 
       
   276 	IMPORT_C void RemoveItemL(TInt32 aTransactionId, TPosLmItemId aItemId,
       
   277 			TPosItem aItemIsLandmark, const TDesC& aDatabaseUri = KNullDesC);
   256 	/**
   278 	/**
   257 	 * RemoveItemL.
   279 	 * RemoveItemL.
   258 	 * Removes the given database.
   280 	 * Removes the given database.
   259 	 * @param aDatabaseUri The URI of the database to be removed from terminal.
   281 	 * @param aDatabaseUri The URI of the database to be removed from terminal.
   260 	 */
   282 	 */
   276 	 * @param aDatabaseUri The URI of the database in which the landmarks and category exist.
   298 	 * @param aDatabaseUri The URI of the database in which the landmarks and category exist.
   277 	 */
   299 	 */
   278 	IMPORT_C void LinkCategoryToLandmarksL( TPosLmItemId aCategoryId,
   300 	IMPORT_C void LinkCategoryToLandmarksL( TPosLmItemId aCategoryId,
   279 			RArray< TPosLmItemId >& aLandmarkIdArray,
   301 			RArray< TPosLmItemId >& aLandmarkIdArray,
   280 			const TDesC& aDatabaseUri = KNullDesC );
   302 			const TDesC& aDatabaseUri = KNullDesC );
       
   303 	IMPORT_C void LinkCategoryToLandmarksL(TInt32 aTransactionId,
       
   304 			TPosLmItemId aCategoryId, RArray<TPosLmItemId>& aLandmarkIdArray,
       
   305 			const TDesC& aDatabaseUri = KNullDesC);
   281 
   306 
   282 	/**
   307 	/**
   283 	 * UnlinkCategoryToLandmarksL.
   308 	 * UnlinkCategoryToLandmarksL.
   284 	 * Dissociates a category with a set of landmarks.
   309 	 * Dissociates a category with a set of landmarks.
   285 	 * @param aCategoryId The id of category.
   310 	 * @param aCategoryId The id of category.
   288 	 * @param aDatabaseUri The URI of the database in which the landmarks and category exist.
   313 	 * @param aDatabaseUri The URI of the database in which the landmarks and category exist.
   289 	 */
   314 	 */
   290 	IMPORT_C void UnlinkCategoryToLandmarksL( TPosLmItemId aCategoryId,
   315 	IMPORT_C void UnlinkCategoryToLandmarksL( TPosLmItemId aCategoryId,
   291 			RArray< TPosLmItemId >& aLandmarkIdArray,
   316 			RArray< TPosLmItemId >& aLandmarkIdArray,
   292 			const TDesC& aDatabaseUri = KNullDesC );
   317 			const TDesC& aDatabaseUri = KNullDesC );
       
   318 	IMPORT_C void UnlinkCategoryToLandmarksL(TInt32 aTransactionId,
       
   319 			TPosLmItemId aCategoryId, RArray<TPosLmItemId>& aLandmarkIdArray,
       
   320 			const TDesC& aDatabaseUri = KNullDesC );
   293 
   321 
   294 	/**
   322 	/**
   295 	 * RegisterObserver.
   323 	 * RegisterObserver.
   296 	 * Registers an observer for Asynchronous call backs.
   324 	 * Registers an observer for Asynchronous call backs.
   297 	 * @param aObserver A pointer to a concrete MLandmarkObserver instance.
   325 	 * @param aObserver A pointer to a concrete MLandmarkObserver instance.