WriteRawChars (IXmlWriterLite)
Writes out raw markup manually. This method allows an application to avoid creating entities for special characters.
Syntax
HRESULT WriteRawChars (const WCHAR * characters, UINT count);
Arguments
characters
Pointer to the characters to write. NULL is valid only if count
is zero.
count
The number of characters to write.
Return Value
Returns S_OK if no error is generated.
Remarks
Writes nothing if the count
parameter is 0 or if the characters
parameter is NULL.
The following example shows the use of WriteRawChars
:
if (FAILED(hr = pWriter->WriteRawChars(L"<rawCharacters/>", 16)))
{
wprintf(L"Error, Method: WriteRawChars, error is %08.8lx", hr);
return -1;
}
For a more detailed example of WriteRawChars
, see Write an XML Document using XmlLite.
Note that the writer does not check whether the written text is well-formed XML in the current context.
Requirements
Header: XmlLite.h
Library: XmlLite.lib