/*

 * 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: 

 * Client-side API tests an implementation of the session count server

 * by implementing a handle to a session.

 *

 */

 /**

  @file

 */

 #include "scstestclient.h"

 #include "scstestcommon.h"

 EXPORT_C RScsTestSession::RScsTestSession()

 /**

 	This constructor defines a single point from which

 	the base class constructor is called.

  */

 :	RScsClientBase()

 	{

 	// empty.

 	}

 EXPORT_C TInt RScsTestSession::Connect()

 /**

 	Connect to the SCS test server using the default version.

 	@return					Symbian OS error code where KErrNone indicates

 							success and any other value indicates failure.

  */

 	{

 	const TVersion serverVersion = ScsTestImpl::Version();

 	return Connect(serverVersion);

 	}

 EXPORT_C TInt RScsTestSession::Connect(const TVersion& aVersion)

 /**

 	Connect to the SCS test server with the supplied version.  This

 	function is defined to test the version checking functionality in

 	CScsServer.  A client API would normally just ask for a server

 	version which at least matches its own.

 	@param	aVersion		Server version to ask for.

 	@return					Symbian OS error code where KErrNone indicates

 							success and any other value indicates failure.

  */

 	{

 	const TUidType serverFullUid = ScsTestImpl::ServerImageFullUid();

 	TInt r = RScsClientBase::Connect(

 		ScsTestImpl::KServerName, aVersion,

 		ScsTestImpl::KServerImageName, serverFullUid);

 	return r;

 	}

 EXPORT_C TInt RScsTestSession::SendCustomFunction(TInt aFunction)

 /**

 	Sends the supplied function identifier to the server with

 	no IPC arguments.  This function should be used to test the

 	server can handle an invalid SCS or session function.

 	@param	aFunction		Function identifier to send to server-side

 							session.  This is sent as-is, and can use the

 							SCS field.

  */

 	{

 	return SendReceive(aFunction);

 	}

 EXPORT_C TInt RScsTestSession::NukeServer()

 /**

 	Calls an synchronous function which causes the server to panic

 */

 	{

 	return CallSessionFunction(ScsTestImpl::ESessNukeServer);

 	}

 EXPORT_C TInt RScsTestSession::Double(TInt& aValue)

 /**

 	Calls a synchronous session function to ensure the function

 	call is routed to the session subclass on the server side.

 	@param	aValue			An arbitrary integer.  On completion

 							this should be double its entry value.

 	@return					Symbian OS error code where KErrNone indicates

 							success and any other value indicates failure.

  */

 	{

 	TPckg<TInt> valPckg(aValue);

 	TIpcArgs ipc(&valPckg);

 	return CallSessionFunction(ScsTestImpl::ESessDouble, ipc);

 	}

 EXPORT_C void RScsTestSession::Treble(TDes8& aValue, TRequestStatus& aStatus)

 /**

 	Calls an asynchronous function to test the SCS can successfully manage

 	asynchronous requests.

 	@param	aValue			Describes an integer, e.g. TPckgBuf<TInt>.

 							The descriptor must be supplied by the caller

 							instead of being constructed in this function

 							because it must persist until the request has

 							been completed.

 	@param	aStatus			The server will complete this status object

 							when it has handled the function.

 	@see CancelTreble

  */

 	{

 	TIpcArgs ipc(&aValue);

 	CallSessionFunction(ScsTestImpl::ESessTreble, ipc, aStatus);

 	}

 EXPORT_C void RScsTestSession::CancelTreble()

 /**

 	Cancel an outstanding request set up with Treble.  This function has

 	no effect if there is no outstanding request.

 	@see Treble

  */

 	{

 	CancelSessionFunction(ScsTestImpl::ESessTreble);

 	}