WriteChars

 

Writes out the specified text content, escaping markup.

Syntax

  
HRESULT WriteChars (const WCHAR * characters, UINT count);  

Arguments

characters
The characters to write. NULL is only valid if count is zero.

count
The number of characters to be written.

Return Value

Returns S_OK if no error is generated.

Remarks

If characters is NULL, this method writes out the text with no data content. That is, the value written is "".

Surrogate pair characters cannot be split across multiple buffer writes when the WriteChars method is called. Therefore, surrogate pairs require special handling. The XML specification defines the valid ranges for surrogate pairs.

For an example of the WriteChars method, see Write an XML Document using XmlLite.

Requirements

Header: XmlLite.h

Library: XmlLite.lib

See Also

IXmlWriter Methods