Share via


ISAXXMLReader::putEntityResolver Method (Compact 2013)

3/26/2014

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

Header

msxml2.h,
msxml2.idl

Library

uuid.lib

See Also

Reference

ISAXXMLReader
ISAXXMLReader::getEntityResolver Method