ISAXContentHandler::skippedEntity Method
A version of this page is also available for
4/8/2010
This method receives notification of a skipped entity.
Syntax
HRESULT skippedEntity(
const wchar_t* pwchName,
int cchName
);
Parameters
- pwchName
[in] Pointer to the name of the skipped entity. If the entity is a parameter entity, the name begins with '%'.
- cchName
[in] Number of characters in the pwchName string.
Return Value
- S_OK
Returned if no errors occur.
- E_FAIL
Returned if the parse operation should be aborted.
Remarks
The skippedEntity method is invoked for each entity skipped. The reader may skip entities if they have not been seen in the declarations — for example, when an entity is declared in an external DTD subset. The reader may skip external entities, depending on the values of the "https://xml.org/sax/features/external-general-entities" and "https://xml.org/sax/features/external-parameter-entities" features. For more information, see the putFeature method.
The following code sample shows that the skippedEntity method is also called in the case of an external DTD declaration.
<!DOCTYPE xyz SYSTEM "https://...">
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 |