ISAXXMLReader::putEntityResolver Method

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method allows an application to register an entity resolver.

At this time, the EntityResolver property cannot be set for this implementation of SAX2 (Simple API for XML).

Syntax

HRESULT putEntityResolver(
  ISAXEntityResolver* pResolver
);

Parameters

• pResolver
  [in] Pointer to the entity resolver to register.

Return Value

• E_FAIL
  Always returned because the EntityResolver property cannot be set for the current SAX2 implementation.

Remarks

If the application does not register an entity resolver, the reader performs its own default resolution. An application can register a new or different entity resolver while in the middle of parsing a document, and the reader will immediately start using the new entity resolver.

The ISAXEntityResolver interface provides a way to resolve references to external entities (data held in separate files identified by a system or public identifier). The reader automatically resolves internal entities, character references, and predefined entities. However, some applications build XML documents from databases and specialized input sources that use Uniform Resource Identifier (URI) types rather than URLs. When external entities cannot be found by URL, a SAX application should provide a class that implements the EntityResolver interface.

Requirements

See Also

Reference

ISAXXMLReader::getEntityResolver Method
ISAXXMLReader