Windows Dev Center

Expand Minimize

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 codeDescription
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

Minimum supported client

Windows 7 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2008 R2 [desktop apps | Windows Store apps]

Header

WebServices.h

Library

WebServices.lib

DLL

WebServices.dll

 

 

Community Additions

ADD
Show:
© 2015 Microsoft