// 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