Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 |
|---|---|
|
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. |
|
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 |