Edit

WsReadStartElement function (webservices.h)

  • Article

Calling this function advances the reader past a start element skipping any whitespace.

After parsing if the Reader is not positioned on a start element it will return a WS_E_INVALID_FORMAT exception.

(See Windows Web Services Return Values.)

Syntax

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

Parameters

[in] reader

A pointer to the XML Reader object used to read the Start element.

[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.
WS_E_QUOTA_EXCEEDED
 A quota was exceeded.

Remarks

This function can fail for any of the reasons listed in WsReadNode.

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