WsReadNode function
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 WINAPI WsReadNode( _In_ WS_XML_READER* reader, _In_opt_ WS_ERROR* error );
Parameters
- reader [in]
-
A pointer to the XML Reader object to advance. The pointer must reference a valid WS_XML_READER and it may not be NULL.
- error [in, optional]
-
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
|
Minimum supported client | Windows 7 [desktop apps | Windows Store apps] |
|---|---|
|
Minimum supported server | Windows Server 2008 R2 [desktop apps | Windows Store apps] |
|
Header |
|
|
Library |
|
|
DLL |
|