Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

WsReadNode function (webservices.h)

This operation advances the Reader to the next node in the input stream. If there is an error parsing the input the function will return WS_E_INVALID_FORMAT. (See Windows Web Services Return Values.)

Syntax

HRESULT WsReadNode(
 [in] WS_XML_READER *reader,
 [in, optional] WS_ERROR *error
);

Parameters

[in] reader

A pointer to the XML Reader object to advance. The pointer must reference a valid WS_XML_READER and it may not be NULL.

[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
WS_E_INVALID_FORMAT
The input data was not in the expected format, or did not have the expected value, or multiple top-level elements were found and WS_XML_READER_PROPERTY_ALLOW_FRAGMENT is FALSE.
WS_E_QUOTA_EXCEEDED
An element was read that exceeded some limit such as WS_XML_READER_PROPERTY_MAX_DEPTH or WS_XML_READER_PROPERTY_MAX_ATTRIBUTES.

Remarks

Other exception conditions include:

  • If an XML declaration is found and WS_XML_READER_PROPERTY_READ_DECLARATION is FALSE, WS_E_INVALID_FORMAT is returned.
  • If the Reader is using WS_XML_READER_STREAM_INPUT and there was insufficient data buffered the reader will return WS_E_QUOTA_EXCEEDED.

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

Feedback

Was this page helpful?

Additional resources