nf-webservices-wswritechars.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:webservices.WsWriteChars	WsWriteChars function (webservices.h)	Writes a series of characters to an element or attribute.	WsWriteChars WsWriteChars function [Web Services for Windows] webservices/WsWriteChars wsw.wswritechars	wsw\wswritechars.htm	wsw	e435058f-62b5-4ae9-800e-e022033a9664	12/05/2018	WsWriteChars, WsWriteChars function [Web Services for Windows], webservices/WsWriteChars, wsw.wswritechars	webservices.h		Windows	Windows 7 [desktop apps \| UWP apps]	Windows Server 2008 R2 [desktop apps \| UWP apps]										WebServices.lib	WebServices.dll		Windows			19H1	WsWriteChars webservices/WsWriteChars	c++	APIRef kbSyntax	DllExport	WebServices.dll	WsWriteChars

WsWriteChars function

-description

Writes a series of characters to an element or attribute.

To write characters to an attribute value, call WsWriteStartAttribute first. Only whitespace characters may be written at the root of an xml document unless the WS_XML_WRITER_PROPERTY_ALLOW_FRAGMENT has been set to TRUE.

-parameters

-param writer [in]

A pointer to the WS_XML_WRITER object to which the characters are written. The pointer must reference a valid XML Writer object.

-param chars

A pointer to the characters to write.

-param charCount [in]

The number of characters to write.

-param error [in, optional]

A pointer to a WS_ERROR object where additional information about the error should be stored if the function fails.

-returns

This function can return one of these values.

Return code	Description
E_INVALIDARG	One or more arguments are invalid.
WS_E_INVALID_OPERATION	The operation is not allowed due to the current state of the object.

-remarks

WsWriteChars can be called more than once between WsWriteStartAttribute and WsWriteEndAttribute. It cannot be combined with WsWriteCharsUtf8, WsWriteBytes, WsWriteValue or WsWriteText when writing an attribute.