ISAXXMLReader::putEntityResolver Method
A version of this page is also available for
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
| Header | msxml2.h, msxml2.idl |
| Library | uuid.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |