WsFillReader 函数 (webservices.h)

  • 项目

确保读取器已缓冲 XML 数据的最小字节计数，以供后续读取器函数使用。 它将根据需要多次调用 由 WS_XML_READER_STREAM_INPUT 指定的回调，以获取 minSize 参数的值指定的字节数。 完成后，缓冲的数据可供其他读取器函数使用。 如果后续读取器函数所需的数据多于已获取的数据，该函数将返回 WS_E_QUOTA_EXCEEDED 异常。 (请参阅 Windows Web Services 返回值。)

语法

HRESULT WsFillReader(
  [in]           WS_XML_READER          *reader,
  [in]           ULONG                  minSize,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

参数

[in] reader

指向用于获取数据的 WS_XML_READER 结构的指针。

[in] minSize

指定读取器应获取的最小字节数。 如果缓冲的当前字节计数等于或大于 minSize 的值，则函数将不执行任何操作，并且将立即返回。

[in, optional] asyncContext

指向 WS_ASYNC_CONTEXT 数据结构的指针，其中包含有关异步调用函数的信息。 NULL 值指示同步操作的请求。

[in, optional] error

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

返回值

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

返回代码 说明
WS_S_ASYNC
 异步操作仍处于挂起状态。

注解

读取特定 XML 数据段所需的字节数取决于编码及其格式设置。

当使用 WS_XML_READER_BUFFER_INPUT 与读取器一起使用时，此函数是“no-op”。

通过指定 WS_ASYNC_CONTEXT 异步读取数据。

要求

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