Symbian3/SDK/Source/GUID-5DACAB53-6D32-5250-9BC2-3E8597C3E2B2.dita
changeset 0 89d6a7a84779
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-5DACAB53-6D32-5250-9BC2-3E8597C3E2B2.dita	Thu Jan 21 18:18:20 2010 +0000
@@ -0,0 +1,118 @@
+<?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>
\ No newline at end of file