Функция WsFillReader (webservices.h)

Гарантирует, что модуль чтения буферизовал минимальное число байтов XML-данных для использования последующими функциями чтения. Он будет вызывать обратный вызов, указанный WS_XML_READER_STREAM_INPUT столько раз, сколько необходимо для получения количества байтов, указанного значением параметра minSize . По завершении буферизация данных становится доступной для других функций чтения. Если последующей функции чтения требуется больше данных, чем было получено, функция вернет WS_E_QUOTA_EXCEEDED исключение. (См. раздел Возвращаемые значения веб-служб Windows.)

Синтаксис

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-данных, зависит от кодировки и ее форматирования.

Эта функция является "no-op" при использовании со средством чтения с помощью WS_XML_READER_BUFFER_INPUT.

При указании WS_ASYNC_CONTEXT данные считываются асинхронно.

Требования

Требование Значение
Минимальная версия клиента Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header webservices.h
Библиотека WebServices.lib
DLL WebServices.dll