<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 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: 

-->

<!DOCTYPE concept

  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

<concept id="GUID-5DACAB53-6D32-5250-9BC2-3E8597C3E2B2" xml:lang="en"><title>XML

Framework Reference</title><prolog><metadata><keywords/></metadata></prolog><conbody>

<section><title>Error codes</title> <p>Error codes refer to six areas of functionality

and the names are self-explanatory. When a parser fails, it calls a <codeph>Leave()</codeph> function

with the appropriate error code as a parameter. A plug-in may not require

some of the error codes, depending on its functionality. </p> <p><b>Plug-in

selection errors</b> </p> <p>Plug-in selection errors are returned by the

framework when ECOM fails to supply a plug-in. </p> <table id="GUID-CD7C37E6-91CC-5CFF-977C-C944DFADA543">

<tgroup cols="1"><colspec colname="col0"/>

<tbody>

<row>

<entry><p> <xref href="GUID-FA8A777E-1835-3D31-BFE6-6B7438878293.dita"><apiname>KErrXmlGeneratorPluginNotFound</apiname></xref>  </p> </entry>

</row>

<row>

<entry><p> <xref href="GUID-DCAD8131-EA4D-3F6A-92AD-5444557277AD.dita"><apiname>KErrXmlParserPluginNotFound</apiname></xref>  </p> </entry>

</row>

<row>

<entry><p> <xref href="GUID-98260C97-9017-3892-83CC-7441DB10E610.dita"><apiname>KErrXmlPluginNotFound</apiname></xref>  </p> </entry>

</row>

<row>

<entry><p> <xref href="GUID-90890D4D-8725-3F8C-A3B4-968ED0357508.dita"><apiname>KErrXmlStringDictionaryPluginNotFound</apiname></xref>  </p> </entry>

</row>

</tbody>

</tgroup>

</table> <p><b>Charset converter errors</b> </p> <p>Charset converter errors

are returned by <codeph>CCharSetConverter</codeph>. A character set may not

be supported or is not available. Not available means that there is no functionality

to convert to and from that character set. </p> <table id="GUID-8F80E4F4-AA70-5ED6-B77E-8FD308F257DC">

<tgroup cols="1"><colspec colname="col0"/>

<tbody>

<row>

<entry><p> <xref href="GUID-1FC7DDA5-CC01-31A6-A3B3-E225CD03CB99.dita"><apiname>KErrXmlBadCharacterConversion</apiname></xref>  </p> </entry>

</row>

<row>

<entry><p> <xref href="GUID-29CE1F85-4E87-38B2-8EB4-98C364AE60A4.dita"><apiname>KErrXmlUnavailableCharacterSet</apiname></xref>  </p> </entry>

</row>

<row>

<entry><p> <xref href="GUID-CF83FF85-F1CC-391C-98CF-CA5DCB19FBB1.dita"><apiname>KErrXmlUnsupportedCharacterSet</apiname></xref>  </p> </entry>

</row>

</tbody>

</tgroup>

</table> <p><b>String dictionary errors</b> </p> <p>String dictionary errors

are returned by the automatically generated string dictionary code. </p> <table id="GUID-46FCF069-83FA-5AE9-B869-2A1F3BA317DD">

<tgroup cols="1"><colspec colname="col0"/>

<tbody>

<row>

<entry><p> <xref href="GUID-8DC231D0-495E-3E67-BD79-6C6036465A90.dita"><apiname>KErrXmlMissingStringDictionary</apiname></xref>  </p> </entry>

</row>

<row>

<entry><p> <xref href="GUID-94AC16BD-C398-3DF7-AF38-7248501C9FC0.dita"><apiname>KErrXmlUnsupportedAttribute</apiname></xref>  </p> </entry>

</row>

<row>

<entry><p> <xref href="GUID-8801ABEA-499E-340F-A55A-4CD3155A121E.dita"><apiname>KErrXmlUnsupportedAttributeValue</apiname></xref>  </p> </entry>

</row>

<row>

<entry><p> <xref href="GUID-DE3F2987-DCC9-37AB-B60B-F7B3D56A0C0F.dita"><apiname>KErrXmlUnsupportedElement</apiname></xref>  </p> </entry>

</row>

</tbody>

</tgroup>

</table> <p><b>General errors</b> </p> <p>General errors refer to an entire

document rather than local parse failures. </p> <table id="GUID-E689FA0B-30AC-53B8-995D-105D7C497633">

<tgroup cols="1"><colspec colname="col0"/>

<tbody>

<row>

<entry><p> <xref href="GUID-97A453E5-765F-36F2-85E6-89056C091AD6.dita"><apiname>KErrXmlBadIndex</apiname></xref>  </p> </entry>

</row>

<row>

<entry><p> <xref href="GUID-7992934C-9ED6-39C8-B048-ED6C1F974AD6.dita"><apiname>KErrXmlDocumentCorrupt</apiname></xref>  </p> </entry>

</row>

<row>

<entry><p> <xref href="GUID-3E1DF5F4-6291-3F07-B8DA-E44BBB98109B.dita"><apiname>KErrXmlStringPoolTableNotFound</apiname></xref>  </p> </entry>

</row>

<row>

<entry><p> <xref href="GUID-88D7C1D0-3C27-33C3-BCB8-16FBC0F0ED59.dita"><apiname>KErrXmlUnsupportedDocumentVersion</apiname></xref>  </p> </entry>

</row>

<row>

<entry><p> <xref href="GUID-E5F42857-C5F7-3690-A488-2396976DB32D.dita"><apiname>KErrXmlUnsupportedExtInterface</apiname></xref>  </p> </entry>

</row>

</tbody>

</tgroup>

</table> <p><b>Parser selection errors</b> </p> <p>There is only one error

code associated with the parser selection functionality. <xref href="GUID-10A59E15-6F27-3E2A-8CD3-A4942A52C1EB.dita"><apiname>KErrXmlMoreThanOneParserMatched</apiname></xref> is

returned if the <xref href="GUID-5CC299E8-C845-3A8C-8C44-0B10610D0D1D.dita"><apiname>KXmlLeaveOnManyFlag</apiname></xref> flag is set. </p> <table id="GUID-3682F377-D97B-547F-9DCC-28FAEDD50573">

<tgroup cols="1"><colspec colname="col0"/>

<tbody>

<row>

<entry><p> <xref href="GUID-10A59E15-6F27-3E2A-8CD3-A4942A52C1EB.dita"><apiname>KErrXmlMoreThanOneParserMatched</apiname></xref>  </p> </entry>

</row>

</tbody>

</tgroup>

</table> <p><b>Other errors</b> </p> <p>The constants <xref href="GUID-9086EEB4-9723-3FAC-8D7A-AC5006457B15.dita"><apiname>KErrXmlFirst</apiname></xref> and <xref href="GUID-C445558A-10FA-315B-B735-FB14549A9F99.dita"><apiname>KErrXmlLast</apiname></xref> are

not error codes but they are the bounds of the XML error message space. They

specify that only XML errors must be handled. </p> <table id="GUID-F7A2289B-D3AB-561D-95C5-3717196E2724">

<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>

<tbody>

<row>

<entry><p> <xref href="GUID-9086EEB4-9723-3FAC-8D7A-AC5006457B15.dita"><apiname>KErrXmlFirst</apiname></xref>  </p> </entry>

<entry><p>XML error must be handled first. </p> </entry>

</row>

<row>

<entry><p> <xref href="GUID-C445558A-10FA-315B-B735-FB14549A9F99.dita"><apiname>KErrXmlLast</apiname></xref>  </p> </entry>

<entry><p>XML error must be handled last. </p> </entry>

</row>

</tbody>

</tgroup>

</table> </section>

</conbody></concept>