// Copyright (c) 2006-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:

// Content handler for binary data

//

/**

 @file

 @publishedAll

 @released

*/

#ifndef XMLENGEXTENDEDCONTENTHANDLER_H

#define XMLENGEXTENDEDCONTENTHANDLER_H

#include <xml/dom/xmlengdatacontainer.h>

/**

This class extends MContentHandler with functions for binary data handling.

Used by clients during XOP deserialization.

@see Xml::MContentHandler

*/

class MXmlEngExtendedHandler

	{

public:

	/** The uid identifying this extension interface. */

	enum TExtInterfaceUid {EExtInterfaceUid = 0x101F9794}; 

	/**

	Called when binary content has been parsed.

	@param aBytes The raw binary data of the element

	@param aCid The CID of the binary data

	@param aErrorcode The parsing error code.  If this is not KErrNone, special

	action may be required.

	@leave - One of the system-wide error codes

 	*/

	virtual void OnBinaryContentL(const TDesC8& aBytes,

	                              const TDesC8& aCid,

	                              TInt aErrorCode) = 0;

	/**

	Called when a reference to external data has been parsed.  

	@see CXmlEngDeserializer::ExternalData()

	Any class derived from TXmlEngDataContainer may be passed to this function.

	@see TXmlEngBinaryContainer

	@see TXmlEngChunkContainer

	@see TXmlEngFileContainer

	@param aContainer The container that holds the external binary data.

	@param aErrorcode The parsing error code.  If this is not KErrNone, special

	action may be required.

	@leave - One of the system-wide error codes

 	*/	

	virtual void OnDataContainerL( const TXmlEngDataContainer& aContainer, 

								   TInt aErrorCode) = 0;

	};

#endif //XMLENGINE_EXTENDEDCONTENTHANDLER_H