/*
* Copyright (c) 2003 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:  Provides a single header for the cXML Parser
*
*/



#ifndef _CXML_FILE_IF_H_
#define _CXML_FILE_IF_H_

#include <xml/cxml/cxml_proj.h>

#ifdef __cplusplus
extern "C" {
#endif

  /** ----------------------------------------------------------------------- **
    @function:     CXML_File_Read
    @synopsis:    Read the contents from the file and store in a buffer.
    @scope:       public      

    @parameters: 
        [in] fileName
                  

        [out] CXML_Uint8* buf
                  Buffer to store the file contents and buffer need to freed from the
                  calling function.
				  (-1): In case of error.


        [out] CXML_Uint32* bufferLen
                       Length of the Buffer        

    @description: Read contents from the file and store these in a buffer to be 
                         read by the cXML parser.

    @returns:   
                  In case of file  related failures:  Error codes is returned defined in 
				                                      nwx_status.h
                  NW_STAT_FAILURE : For any general error.
                  NW_STAT_SUCCESS: For success
 -----------------------------------------------------------------------------------**/

IMPORT_C
NW_Status_t  CXML_Read_From_File(NW_Byte* fileName,NW_Uint8** buf, NW_Int32* bufferLen);

#ifdef __cplusplus 
} /* extern "C" { */
#endif /* __cplusplus */

#endif //_CXML_FILE_IF_H_