WsReadStartAttribute 函数 (webservices.h)

将读取器移动到指定的属性,以便可以使用 WsReadValueWsReadCharsWsReadBytes 读取内容。

如果读取器未定位在 start 元素上,则返回 WS_E_INVALID_FORMAT 异常。

(请参阅 Windows Web Services 返回值。)

注意 读取的属性不会以任何特定顺序显示。 WsFindAttribute 可用于查找特定属性的索引。

 

语法

HRESULT WsReadStartAttribute(
  [in]           WS_XML_READER *reader,
  [in]           ULONG         attributeIndex,
  [in, optional] WS_ERROR      *error
);

参数

[in] reader

指向用于读取 Start 属性的 XML Reader 对象的指针。

[in] attributeIndex

要读取的属性的索引。

[in, optional] error

指向 WS_ERROR 对象的指针,如果函数失败,应存储有关错误的其他信息。

返回值

此函数可以返回其中一个值。

返回代码 说明
WS_E_INVALID_FORMAT
输入数据的格式不是预期的,或者没有预期的值。

注解

WsReadNode 函数在属性中高级时返回 EOF。 WsReadEndAttribute 函数可用于将读取器返回到包含元素。

要求

要求
最低受支持的客户端 Windows 7 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2 [桌面应用 |UWP 应用]
目标平台 Windows
标头 webservices.h
Library WebServices.lib
DLL WebServices.dll