// Copyright (c) 2005-2009 Nokia Corporation and/or its subsidiary(-ies).

// All rights reserved.

// This component and the accompanying materials are made available

// under the terms of "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:

//

/**

 @file

 @internalTechnology

*/

#if !defined(RESPONSEMSG_H)

#define RESPONSEMSG_H

#include <e32base.h>

#include <elements/metavirtctor.h>

#include <elements/sd_apiextensionclient.h>

namespace Elements

{

/**

	The RResponseMsg class provides a controlled wrapper around an IPC

	client-provided RMessage2.

	@publishedPartner

	@released

*/

class RResponseMsg : protected RMessage2

	{

	friend class TResponseMsgAccessor;

public:

	explicit RResponseMsg() : iInterfaceId(0), iRequestMsgParam(-1), iResponseMsgParam(-1) {}

	IMPORT_C explicit RResponseMsg(const RMessage2& aMessage, TInt aInterfaceId, TInt aRequestMsgParam = -1, TInt aResponseMsgParam = -1);

	IMPORT_C explicit RResponseMsg(const RMessage2& aMessage, const Den::TApiExtIdentification& aInterfaceId, TInt aRequestMsgParam = -1, TInt aResponseMsgParam = -1);

	IMPORT_C TInt InterfaceId() const;

	IMPORT_C TInt ScopeId() const;

	IMPORT_C Meta::SMetaDataNetCtor* ReadClientReqMsg(TDes8& aDstBuff);

	IMPORT_C void Complete(TInt aError);

	IMPORT_C void Complete(Meta::SMetaDataECom& aMsg);

	IMPORT_C void Complete(Meta::SMetaDataECom& aMsg, TDes8& aDstBuff);

	IMPORT_C void Complete(RHandleBase& aHandle); 	       

	IMPORT_C void Panic(const TDesC& aCategory, TInt aReason) const;

	inline TInt GetDesLength(TInt aParam) const

		{

		return RMessage2::GetDesLength(aParam);

		}

	inline TInt GetDesLengthL(TInt aParam) const

		{

		return RMessage2::GetDesLengthL(aParam);

		}

	inline TInt GetDesMaxLength(TInt aParam) const

		{

		return RMessage2::GetDesMaxLength(aParam);

		}

	inline TInt GetDesMaxLengthL(TInt aParam) const

		{

		return RMessage2::GetDesMaxLengthL(aParam);

		}

	inline void ReadL(TInt aReadParam, TDes8& aBuf, TInt aOffset=0) const

		{

		RMessage2::ReadL(aReadParam, aBuf, aOffset);

		}

	inline void ReadL(TInt aReadParam, TDes16& aBuf, TInt aOffset=0) const

		{

		RMessage2::ReadL(aReadParam, aBuf, aOffset);

		}

	inline TInt Read(TInt aReadParam, TDes8& aBuf, TInt aOffset=0) const

		{

		return RMessage2::Read(aReadParam, aBuf, aOffset);

		}

	inline TInt Read(TInt aReadParam, TDes16& aBuf, TInt aOffset=0) const

		{

		return RMessage2::Read(aReadParam, aBuf, aOffset);

		}

	inline void WriteL(TInt aWriteParam, const TDesC8& aBuf, TInt aOffset=0) const

		{

		RMessage2::WriteL(aWriteParam, aBuf, aOffset);

		}

	inline void WriteL(TInt aWriteParam, const TDesC16& aBuf, TInt aOffset=0) const

		{

		RMessage2::WriteL(aWriteParam, aBuf, aOffset);

		}

	inline TInt Write(TInt aWriteParam, const TDesC8& aBuf, TInt aOffset=0) const

		{

		return RMessage2::Write(aWriteParam, aBuf, aOffset);

		}

	inline TInt Write(TInt aWriteParam, const TDesC16& aBuf, TInt aOffset=0) const

		{

		return RMessage2::Write(aWriteParam, aBuf, aOffset);

		}

	inline TInt Function() const

		{

		return RMessage2::Function();

		}

	inline TInt Int0() const

		{

		return RMessage2::Int0();

		}

	inline TInt Int1() const

		{

		return RMessage2::Int1();

		}

	inline TInt Int2() const

		{

		return RMessage2::Int2();

		}

	inline TInt Int3() const

		{

		return RMessage2::Int3();

		}

	inline const TAny* Ptr0() const

		{

		return RMessage2::Ptr0();

		}

	inline const TAny* Ptr1() const

		{

		return RMessage2::Ptr1();

		}

	inline const TAny* Ptr2() const

		{

		return RMessage2::Ptr2();

		}

	inline const TAny* Ptr3() const

		{

		return RMessage2::Ptr3();

		}

	inline TBool IsNull() const

		{

		return RMessage2::IsNull();

		}

	inline TBool HasCapability(TCapability aCapability, const char* aDiagnostic=0) const

		{

		return RMessage2::HasCapability(aCapability, aDiagnostic);

		}

private:

	Den::TApiExtIdentification iInterfaceId;

	TInt8 iRequestMsgParam;

	TInt8 iResponseMsgParam;

	};

} // namespace Elements

#endif	// RESPONSEMSG_H