ISAXContentHandler::endElement Method

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method receives notification of the end of an element.

Syntax

HRESULT endElement(
  const wchar_t* pwchNamespaceUri, 
  int cchNamespaceUri, 
  const wchar_t* pwchLocalName, 
  int cchLocalName,
  const wchar_t* pwchQName,
  int cchQName
);

Parameters

• pwchNamespaceUri
  [in] Pointer to the name space URI.

• cchNamespaceUri
  [in] Length for the name space URI string.

• pwchLocalName
  [in] Pointer to the local name string.

• cchLocalName
  [in] Length of the local name string.

• pwchQName
  [in] Pointer to the qualified XML 1.0 name (QName) with prefix or, if QNames are not available, an empty string.

• cchQName
  [in] Length of the QName string.

Return Value

• S_OK
  Returned if no errors occur.

• E_FAIL
  Returned if the parse operation should be aborted.

Remarks

The reader invokes this method at the end of every element in the XML document. A corresponding startElement event occurs for every endElement event, even when the element is empty.

This event allows up to three of the following name components for each element:

• Name space URI
• Local name
• QName or an empty string if the QName is not available

Any or all of these name components may be provided, depending on the values of the "https://xml.org/sax/features/namespaces" and the "https://xml.org/sax/features/namespace-prefixes" features. The name space URI and local name are required when the "https://xml.org/sax/features/namespaces" feature is True (the default). These values are optional when this feature is set to False. Note that neither the URI nor the local name value can be specified on its own. Both values are required.

Requirements

See Also

Reference

ISAXContentHandler::startElement Method
ISAXContentHandler