WsWriteText function (webservices.h)
Writes the specified text to the XML writer.
To write characters to an attribute value call WsWriteStartAttribute. 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.
Syntax
HRESULT WsWriteText(
[in] WS_XML_WRITER *writer,
[in] const WS_XML_TEXT *text,
[in, optional] WS_ERROR *error
);
Parameters
[in] writer
A pointer to the WS_XML_WRITER object to which the text is written. The pointer must reference a valid XML Writer object.
[in] text
A pointer to the text to write.
[in, optional] error
A pointer to a WS_ERROR object where additional information about the error should be stored if the function fails.
Return value
This function can return one of these values.
Return code | Description |
---|---|
|
One or more arguments are invalid. |
|
The operation is not allowed due to the current state of the object. |
Remarks
WsWriteText can be called only once between WsWriteStartAttribute and WsWriteEndAttribute unless the text type is one of the following:
- WS_XML_TEXT_TYPE_UTF8
- WS_XML_TEXT_TYPE_UTF16
- WS_XML_TEXT_TYPE_BASE64
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 7 [desktop apps | UWP apps] |
Minimum supported server | Windows Server 2008 R2 [desktop apps | UWP apps] |
Target Platform | Windows |
Header | webservices.h |
Library | WebServices.lib |
DLL | WebServices.dll |