/*
* Copyright (c) 2007-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 "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: 
*
*/


#include <ups/cliententity.h>
#include <ups/upserr.h>

using namespace UserPromptService;


EXPORT_C CClientEntity* CClientEntity::NewL(const TDesC8& aName)
/**
Creates a new client entity object.
@param aName	A name that uniquely identifies the entity within the context
				of the client process.
@return			A pointer to the new client entity object.						 
*/
	{
	CClientEntity* self = CClientEntity::NewLC(aName);
	CleanupStack::Pop(self);
	return self;
	}

EXPORT_C CClientEntity* CClientEntity::NewLC(const TDesC8& aName)
/**
Creates a new client entity object and places the pointer on the cleanup stack.
@param aName	A name that uniquely identifies the entity within the context
				of the client process.
@return			A pointer to the new client entity object.						 
*/
	{
	CClientEntity* self = new(ELeave) CClientEntity();
	CleanupStack::PushL(self);
	self->ConstructL(aName);
	return self;
	}

void CClientEntity::ConstructL(const TDesC8& aName)
/**
Second phase constructor
@param aClientEntityName A descriptor containing the name of the client entity.
*/
	{	
	if (aName.Length() > KUpsMaxClientEntityLength)
		{
		User::Leave(KErrUpsBadClientEntityLength);
		}
	iName = aName.AllocL();
	}
	
EXPORT_C const TDesC8& CClientEntity::Name() const
/**
Gets the unique name for the client entity.
@return A descriptor containing the client entity name.
*/
	{
	return *iName;
	}

CClientEntity::CClientEntity()
/**
Constructor
*/
	{	
	}
	
CClientEntity::~CClientEntity()
/**
Destructor
*/
	{
	delete iName;
	}