|
1 <?xml version="1.0" encoding="utf-8"?> |
|
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
3 <!-- This component and the accompanying materials are made available under the terms of the License |
|
4 "Eclipse Public License v1.0" which accompanies this distribution, |
|
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> |
|
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <concept id="GUID-5DACAB53-6D32-5250-9BC2-3E8597C3E2B2" xml:lang="en"><title>XML |
|
13 Framework Reference</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
14 <section><title>Error codes</title> <p>Error codes refer to six areas of functionality |
|
15 and the names are self-explanatory. When a parser fails, it calls a <codeph>Leave()</codeph> function |
|
16 with the appropriate error code as a parameter. A plug-in may not require |
|
17 some of the error codes, depending on its functionality. </p> <p><b>Plug-in |
|
18 selection errors</b> </p> <p>Plug-in selection errors are returned by the |
|
19 framework when ECOM fails to supply a plug-in. </p> <table id="GUID-CD7C37E6-91CC-5CFF-977C-C944DFADA543"> |
|
20 <tgroup cols="1"><colspec colname="col0"/> |
|
21 <tbody> |
|
22 <row> |
|
23 <entry><p> <xref href="GUID-FA8A777E-1835-3D31-BFE6-6B7438878293.dita"><apiname>KErrXmlGeneratorPluginNotFound</apiname></xref> </p> </entry> |
|
24 </row> |
|
25 <row> |
|
26 <entry><p> <xref href="GUID-DCAD8131-EA4D-3F6A-92AD-5444557277AD.dita"><apiname>KErrXmlParserPluginNotFound</apiname></xref> </p> </entry> |
|
27 </row> |
|
28 <row> |
|
29 <entry><p> <xref href="GUID-98260C97-9017-3892-83CC-7441DB10E610.dita"><apiname>KErrXmlPluginNotFound</apiname></xref> </p> </entry> |
|
30 </row> |
|
31 <row> |
|
32 <entry><p> <xref href="GUID-90890D4D-8725-3F8C-A3B4-968ED0357508.dita"><apiname>KErrXmlStringDictionaryPluginNotFound</apiname></xref> </p> </entry> |
|
33 </row> |
|
34 </tbody> |
|
35 </tgroup> |
|
36 </table> <p><b>Charset converter errors</b> </p> <p>Charset converter errors |
|
37 are returned by <codeph>CCharSetConverter</codeph>. A character set may not |
|
38 be supported or is not available. Not available means that there is no functionality |
|
39 to convert to and from that character set. </p> <table id="GUID-8F80E4F4-AA70-5ED6-B77E-8FD308F257DC"> |
|
40 <tgroup cols="1"><colspec colname="col0"/> |
|
41 <tbody> |
|
42 <row> |
|
43 <entry><p> <xref href="GUID-1FC7DDA5-CC01-31A6-A3B3-E225CD03CB99.dita"><apiname>KErrXmlBadCharacterConversion</apiname></xref> </p> </entry> |
|
44 </row> |
|
45 <row> |
|
46 <entry><p> <xref href="GUID-29CE1F85-4E87-38B2-8EB4-98C364AE60A4.dita"><apiname>KErrXmlUnavailableCharacterSet</apiname></xref> </p> </entry> |
|
47 </row> |
|
48 <row> |
|
49 <entry><p> <xref href="GUID-CF83FF85-F1CC-391C-98CF-CA5DCB19FBB1.dita"><apiname>KErrXmlUnsupportedCharacterSet</apiname></xref> </p> </entry> |
|
50 </row> |
|
51 </tbody> |
|
52 </tgroup> |
|
53 </table> <p><b>String dictionary errors</b> </p> <p>String dictionary errors |
|
54 are returned by the automatically generated string dictionary code. </p> <table id="GUID-46FCF069-83FA-5AE9-B869-2A1F3BA317DD"> |
|
55 <tgroup cols="1"><colspec colname="col0"/> |
|
56 <tbody> |
|
57 <row> |
|
58 <entry><p> <xref href="GUID-8DC231D0-495E-3E67-BD79-6C6036465A90.dita"><apiname>KErrXmlMissingStringDictionary</apiname></xref> </p> </entry> |
|
59 </row> |
|
60 <row> |
|
61 <entry><p> <xref href="GUID-94AC16BD-C398-3DF7-AF38-7248501C9FC0.dita"><apiname>KErrXmlUnsupportedAttribute</apiname></xref> </p> </entry> |
|
62 </row> |
|
63 <row> |
|
64 <entry><p> <xref href="GUID-8801ABEA-499E-340F-A55A-4CD3155A121E.dita"><apiname>KErrXmlUnsupportedAttributeValue</apiname></xref> </p> </entry> |
|
65 </row> |
|
66 <row> |
|
67 <entry><p> <xref href="GUID-DE3F2987-DCC9-37AB-B60B-F7B3D56A0C0F.dita"><apiname>KErrXmlUnsupportedElement</apiname></xref> </p> </entry> |
|
68 </row> |
|
69 </tbody> |
|
70 </tgroup> |
|
71 </table> <p><b>General errors</b> </p> <p>General errors refer to an entire |
|
72 document rather than local parse failures. </p> <table id="GUID-E689FA0B-30AC-53B8-995D-105D7C497633"> |
|
73 <tgroup cols="1"><colspec colname="col0"/> |
|
74 <tbody> |
|
75 <row> |
|
76 <entry><p> <xref href="GUID-97A453E5-765F-36F2-85E6-89056C091AD6.dita"><apiname>KErrXmlBadIndex</apiname></xref> </p> </entry> |
|
77 </row> |
|
78 <row> |
|
79 <entry><p> <xref href="GUID-7992934C-9ED6-39C8-B048-ED6C1F974AD6.dita"><apiname>KErrXmlDocumentCorrupt</apiname></xref> </p> </entry> |
|
80 </row> |
|
81 <row> |
|
82 <entry><p> <xref href="GUID-3E1DF5F4-6291-3F07-B8DA-E44BBB98109B.dita"><apiname>KErrXmlStringPoolTableNotFound</apiname></xref> </p> </entry> |
|
83 </row> |
|
84 <row> |
|
85 <entry><p> <xref href="GUID-88D7C1D0-3C27-33C3-BCB8-16FBC0F0ED59.dita"><apiname>KErrXmlUnsupportedDocumentVersion</apiname></xref> </p> </entry> |
|
86 </row> |
|
87 <row> |
|
88 <entry><p> <xref href="GUID-E5F42857-C5F7-3690-A488-2396976DB32D.dita"><apiname>KErrXmlUnsupportedExtInterface</apiname></xref> </p> </entry> |
|
89 </row> |
|
90 </tbody> |
|
91 </tgroup> |
|
92 </table> <p><b>Parser selection errors</b> </p> <p>There is only one error |
|
93 code associated with the parser selection functionality. <xref href="GUID-10A59E15-6F27-3E2A-8CD3-A4942A52C1EB.dita"><apiname>KErrXmlMoreThanOneParserMatched</apiname></xref> is |
|
94 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"> |
|
95 <tgroup cols="1"><colspec colname="col0"/> |
|
96 <tbody> |
|
97 <row> |
|
98 <entry><p> <xref href="GUID-10A59E15-6F27-3E2A-8CD3-A4942A52C1EB.dita"><apiname>KErrXmlMoreThanOneParserMatched</apiname></xref> </p> </entry> |
|
99 </row> |
|
100 </tbody> |
|
101 </tgroup> |
|
102 </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 |
|
103 not error codes but they are the bounds of the XML error message space. They |
|
104 specify that only XML errors must be handled. </p> <table id="GUID-F7A2289B-D3AB-561D-95C5-3717196E2724"> |
|
105 <tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/> |
|
106 <tbody> |
|
107 <row> |
|
108 <entry><p> <xref href="GUID-9086EEB4-9723-3FAC-8D7A-AC5006457B15.dita"><apiname>KErrXmlFirst</apiname></xref> </p> </entry> |
|
109 <entry><p>XML error must be handled first. </p> </entry> |
|
110 </row> |
|
111 <row> |
|
112 <entry><p> <xref href="GUID-C445558A-10FA-315B-B735-FB14549A9F99.dita"><apiname>KErrXmlLast</apiname></xref> </p> </entry> |
|
113 <entry><p>XML error must be handled last. </p> </entry> |
|
114 </row> |
|
115 </tbody> |
|
116 </tgroup> |
|
117 </table> </section> |
|
118 </conbody></concept> |