// 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__