ISAXContentHandler::skippedEntity Method

A version of this page is also available for

Windows Embedded CE 6.0 R3

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

See Also

Reference

ISAXXMLReader::putFeature Method
ISAXContentHandler