// Copyright (c) 2004-2009 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:

// Utility functions to retrieve comms data for specific use-cases and present it in a particular way.

// 

//

/**

 @file

 @internalAll

 @released

*/

#ifndef __COMMSDATUTILS_H__

#define	__COMMSDATUTILS_H__

#include <cdbcols.h>

#include <dial.h>

#include <metadatabase.h>

class CCommsDatUtilImpl;

namespace CommsDatUtils

{

class CCommsDatUtils : public CBase

	{

	public :

		IMPORT_C static CCommsDatUtils* NewL();

		IMPORT_C ~CCommsDatUtils();

		//  Set `aDialString` to be the appropriate string based on the directory

		//	number, where the dial is being performed and the chargecard to use.

		//	`ResolvePhoneNumberL()` opens a comms database to perform the

		//	resolution

		IMPORT_C static void ResolvePhoneNumberL(TDesC& aNumber, TDes& aDialString, TParseMode aDialParseMode, TUint32 aLocationId, TUint32 aChargecardId);

		// Set `aDialString` to be the appropriate string based on the directory

		//	number, where the dial is being performed and the chargecard to use.

		IMPORT_C static void ResolvePhoneNumberFromDatabaseL(TDesC& aNumber, TDes& aDialString, TParseMode aDialParseMode, TUint32 aLocationId, TUint32 aChargecardId);

    	// Check access to database fields

	    IMPORT_C TInt CheckReadCapability( const TDesC& aField, const RMessagePtr2* aMessage );

	    IMPORT_C TInt CheckWriteCapability( const TDesC& aField, const RMessagePtr2* aMessage );

	private:

		CCommsDatUtils() {};

		void ConstructL();

	private :

		CCommsDatUtilImpl* iUtilsImpl;

	};

#ifndef SYMBIAN_NON_SEAMLESS_NETWORK_BEARER_MOBILITY

class NameLookUp

	{

	public:

		/** Looks up the field specified and supplies a descriptor matching the name.

		@param aElementId 	The field to look up.

		@param aFieldName 	returns a pointer to the HBufC containing the string.

		@param aDataType 	returns the data type of the found field.

		@return The reversed value. */

		IMPORT_C static TInt FieldNameLookup(CommsDat::TMDBElementId aElementId, HBufC*& aFieldName, TInt& aDataType );

	private:

		NameLookUp() {} // no construction since we are now private.

	};

#endif // SYMBIAN_NON_SEAMLESS_NETWORK_BEARER_MOBILITY

} //end namespace CommsDat::utils

#endif //__COMMSDATUTILS_H__