Partager via

ISAXContentHandler::skippedEntity Method (Compact 2013)

  • Article

3/26/2014

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 "http://xml.org/sax/features/external-general-entities" and "http://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 "http://...">

Requirements

Header

msxml2.h,
msxml2.idl

Library

uuid.lib

See Also

Reference

ISAXContentHandler
ISAXXMLReader::putFeature Method