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.

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.

General errors

General errors refer to an entire document rather than local parse failures.

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.

KErrXmlFirst

XML error must be handled first.

KErrXmlLast

XML error must be handled last.