In the XML SAX (XMLSAX) for Windows CE 5.0 operating system (OS) implementation, all strings returned to handler callbacks consist of two parts: a pointer to the wcharbuffer and the length of the string. This includes strings passed either directly, such as the element name for the startElementmethod, or indirectly, such as strings provided by the ISAXAttributesand ISAXLocatorclasses. Strings returned from these implementations are owned by the implementations, not the calling process. Therefore, their memory should not be released, freed, or deleted. Strings, represented as a pointer to the character buffer and length, may not be zero terminated.

When a string consists of both a pointer to the buffer and a length, the length always contains the correct length of the string; either it is zero-terminated or not. For input parameters, the representation of strings follows traditional zero-terminated Unicode string format, for example, rdr.putBase(L"http://microsoft.com/"). It is not guaranteed that the content of the string will still keep the value at the next call to a handler.

After any successful getPropertycall, the caller should free the memory.

Note:
The XMLSAX property strings are the exception to the general COM rule that system-allocated objects are allocated by the data source and freed by the consumer.

The XMLSAX implementation of SAX2 is nonvalidating. As a result, a validation error does not occur if the same element is declared twice, with different definitions, in an internal DTD. When element/entity declaration conflicts occur, the first declaration takes precedence.

In an entity is declared in an external DTD, XMLSAX reports them as skipped entities and the value of the non-declared (skipped) entity is defaulted to empty. However, XMLSAX does not report entities in attributes. They are quietly skipped.

The following XML features are handled and recognized by SAXXMLReader:

• "http://xml.org/sax/features/namespaces"
  
  
• "http://xml.org/sax/features/namespace-prefixes"
  
  
• "http://xml.org/sax/features/external-general-entities"
  
  
• "http://xml.org/sax/features/external-parameter-entities"
  
  
• "normalize-line-breaks"
  
  
• "server-http-request"
  
  

The following properties are handled and recognized by SAXXMLReader:

• "http://xml.org/sax/properties/lexical-handler"
  
  
• "http://xml.org/sax/properties/declaration-handler"
  
  
• "xmldecl-encoding"
  
  
• "xmldecl-version"
  
  
• "xmldecl-standalone"
  
  

All handlers may return either S_OK to continue or any other non-S_OK error code. For non-S_OK error codes, parsing is aborted and the return value is returned by the parse, parseURL, or resumemethod.

The following table shows the general error codes most parser methods can return.