Функция 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 , в котором должны храниться дополнительные сведения об ошибке в случае сбоя функции.
Эта функция может возвращать одно из этих значений.
Код возврата | Описание |
---|---|
|
Асинхронная операция по-прежнему находится в состоянии ожидания. |
Количество байтов, необходимых для чтения определенного сегмента 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 |