Error codes refer to six areas of functionality
and the names are self-explanatory. When a parser fails, it calls a Leave() function
with the appropriate error code as a parameter. A plug-in may not require
some of the error codes, depending on its functionality.
Plug-in selection errors
Plug-in selection errors are returned by the framework when ECOM fails to supply a plug-in.
KErrXmlGeneratorPluginNotFound |
KErrXmlParserPluginNotFound |
KErrXmlPluginNotFound |
KErrXmlStringDictionaryPluginNotFound |
Charset converter errors
Charset converter errors
are returned by CCharSetConverter. 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.
String dictionary errors
String dictionary errors are returned by the automatically generated string dictionary code.
KErrXmlMissingStringDictionary |
KErrXmlUnsupportedAttribute |
KErrXmlUnsupportedAttributeValue |
KErrXmlUnsupportedElement |
General errors
General errors refer to an entire document rather than local parse failures.
KErrXmlBadIndex |
KErrXmlDocumentCorrupt |
KErrXmlStringPoolTableNotFound |
KErrXmlUnsupportedDocumentVersion |
KErrXmlUnsupportedExtInterface |
Parser selection errors
There is only one error code associated with the parser selection functionality. KErrXmlMoreThanOneParserMatched is returned if the KXmlLeaveOnManyFlag flag is set.
Other errors
The constants KErrXmlFirst and KErrXmlLast are not error codes but they are the bounds of the XML error message space. They specify that only XML errors must be handled.