ISAXContentHandler::characters Method

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method receives notification of character data.

Syntax

HRESULT characters(
  const wchar_t* pwchChars,
  int cchChars
);

Parameters

• pwchChars
  [in] Pointer to the character data.

• cchChars
  [in] Length of the character string.

Return Value

• S_OK
  Returned if the character data is returned successfully.

• E_FAIL
  Returned if an internal error occurs.

Remarks

The reader calls the characters method to report each chunk of character data. The reader can return all contiguous character data in a single chunk or split it into several chunks. All characters in a single event, however, must come from the same external entity so that the Locator object can provide useful information. The application must not attempt to read from the array outside the specified range.

The characters method does not convert carriage-return line feed ("\r\n") to the Java language line feed('\n').

Requirements

See Also

Reference

ISAXContentHandler