WsSetReaderPosition 函数 (webservices.h)

  • 项目

设置读取器的当前位置。 该位置必须通过调用 WsGetReaderPosition 或 WsGetWriterPosition 获取。

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

语法

HRESULT WsSetReaderPosition(
  [in]           WS_XML_READER              *reader,
  [in]           const WS_XML_NODE_POSITION *nodePosition,
  [in, optional] WS_ERROR                   *error
);

参数

[in] reader

指向为其设置了当前位置 的 WS_XML_READER 对象的指针。 指针必须引用有效的 XML 读取器 对象。

[in] nodePosition

指向用于设置读取器的位置的指针。

[in, optional] error

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

返回值

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

返回代码 说明
E_INVALIDARG
 一个或多个参数无效。
WS_E_INVALID_OPERATION
 由于 对象的当前状态，不允许此操作。

注解

有关使用位置的详细信息 ，请参阅WS_XML_NODE_POSITION 。

规范化时不能使用此函数。 如果已调用 WsStartReaderCanonicalization ，则它将返回 WS_E_INVALID_OPERATION。 (请参阅 Windows Web Services 返回值。)

要求

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