XML Framework Reference

Error codes

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.

KErrXmlBadCharacterConversion

KErrXmlUnavailableCharacterSet

KErrXmlUnsupportedCharacterSet

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.

KErrXmlMoreThanOneParserMatched

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.

KErrXmlFirst

XML error must be handled first.

KErrXmlLast

XML error must be handled last.