/*

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

* Defines the client-side classes which other client-side handles

* derive from to use the SCS functionality.

*

*/

/**

 @file

 @publishedAll

 @released

*/

#ifndef SCSCLIENT_H

#define SCSCLIENT_H

#include <e32std.h>

class RScsClientBase : public RSessionBase

/**

	Provides functionality to connect to the server, starting

	the server process if necessary.  This class cannot be used

	directly - the SCS implementor must define a subclass.

 */

	{

public:

	IMPORT_C void Close();

	IMPORT_C TInt SetServerHeapFail(TInt aRate);

	IMPORT_C TInt ResetServerHeapFail();

	IMPORT_C TInt ShutdownServer();

protected:

	IMPORT_C RScsClientBase();

	IMPORT_C TInt Connect(

		const TDesC& aSvrName, const TVersion& aReqVer, const TDesC& aExeName, const TUidType& aFullExeUid);

	IMPORT_C TInt CallSessionFunction(TInt aFunction) const;

	IMPORT_C TInt CallSessionFunction(TInt aFunction, const TIpcArgs& aArgs) const;

	IMPORT_C void CallSessionFunction(TInt aFunction, const TIpcArgs& aArgs, TRequestStatus& aStatus) const;

	IMPORT_C void CancelSessionFunction(TInt aFunction) const;

private:

	TInt StartServerProcess(const TDesC& aExeName, const TUidType& aFullExeUid);	

	};

class RScsClientSubsessionBase : public RSubSessionBase

/**

	This class is used to send messages to server-side SCS subsessions.

	This class cannot be used directly - the implementor must define a

	subclass.

 */

	{

public:

	IMPORT_C void Close();

protected:

	IMPORT_C RScsClientSubsessionBase();

	IMPORT_C TInt CreateSubsession(const RScsClientBase& aSession, TInt aFunction, const TIpcArgs& aArgs);

	IMPORT_C TInt CallSubsessionFunction(TInt aFunction) const;

	IMPORT_C TInt CallSubsessionFunction(TInt aFunction, const TIpcArgs& aArgs) const;

	IMPORT_C void CallSubsessionFunction(TInt aFunction, const TIpcArgs& aArgs, TRequestStatus& aStatus) const;

	IMPORT_C void CancelSubsessionFunction(TInt aFunction) const;

	};

#endif	// #ifndef SCSCLIENT_H