WsReadNode 函数 (webservices.h)

此操作会将读取器推进到输入流中的下一个 节点 。 如果分析输入时出错,函数将返回 WS_E_INVALID_FORMAT。 (请参阅 Windows Web Services 返回值。)

语法

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

参数

[in] reader

指向要前进的 XML Reader 对象的指针。 指针必须引用有效的 WS_XML_READER ,并且不能为 NULL

[in, optional] error

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

返回值

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

返回代码 说明
WS_E_INVALID_FORMAT
输入数据的格式不是预期的,或者没有预期的值,或者找到了多个顶级元素, WS_XML_READER_PROPERTY_ALLOW_FRAGMENTFALSE
WS_E_QUOTA_EXCEEDED
读取的元素超出了某些限制,例如 WS_XML_READER_PROPERTY_MAX_DEPTHWS_XML_READER_PROPERTY_MAX_ATTRIBUTES

注解

其他异常条件包括:

  • 如果找到 XML 声明且 WS_XML_READER_PROPERTY_READ_DECLARATIONFALSE,则返回 WS_E_INVALID_FORMAT
  • 如果读取器正在使用 WS_XML_READER_STREAM_INPUT 并且缓冲的数据不足,则读取器将返回 WS_E_QUOTA_EXCEEDED

要求

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