WsMoveReader 函数 (webservices.h)

移动 由 moveTo 参数指定的读取器当前位置。

此函数只能在设置为 XmlBuffer 的读取器上使用。

语法

HRESULT WsMoveReader(
  [in]           WS_XML_READER *reader,
  [in]           WS_MOVE_TO    moveTo,
                 BOOL          *found,
  [in, optional] WS_ERROR      *error
);

参数

[in] reader

指向 XML Reader 对象的指针,该对象具有要移动的位置。 指针必须引用有效的 WS_XML_READER 对象,并且引用的 Reader 值不能为 NULL

[in] moveTo

此枚举器指定读取器相对于当前位置的方向或下一位置。

found

指示指定移动的成功或失败。

[in, optional] error

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

返回值

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

返回代码 说明
E_INVALIDARG
一个或多个参数无效。
WS_E_INVALID_FORMAT
输入数据未采用预期格式或没有预期值。
WS_E_INVALID_OPERATION
由于对象的当前状态,不允许该操作。

注解

如果找到的参数不为 NULL,它将指示它是否可以移动到请求的节点并返回 NOERROR。

如果找到的参数为 NULL,并且找不到请求的节点,它将返回 WS_E_INVALID_FORMAT。 (请参阅 Windows Web Services 返回值。)

规范化时不能使用此函数。 如果已调用 WsStartReaderCanonicalization ,则它将返回 WS_E_INVALID_OPERATION

要求

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