Поделиться через

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

  • Статья

Указывает средству записи вызвать обратный вызов , указанный в WS_XML_WRITER_STREAM_OUTPUT , если буферизация достаточного объема данных.

Синтаксис

HRESULT WsFlushWriter(
  [in]           WS_XML_WRITER          *writer,
  [in]           ULONG                  minSize,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

Параметры

[in] writer

Модуль записи для очистки.

[in] minSize

Указывает минимальное количество байтов, которые необходимо буферизовывать для вызова обратного вызова . Если буферизовалось меньше этого числа байтов, обратный вызов не будет вызываться. Это позволяет свести к минимуму количество операций ввода-вывода, возникающих при записи небольших объемов данных.

Чтобы гарантировать вызов обратного вызова , необходимо указать ноль.

[in, optional] asyncContext

Сведения об асинхронном вызове функции или значении NULL при синхронном вызове.

[in, optional] error

Указывает, где должны храниться дополнительные сведения об ошибке в случае сбоя функции.

Возвращаемое значение

Эта функция может возвращать одно из этих значений.

Код возврата Описание
E_INVALIDARG
 Один или несколько аргументов являются недопустимыми.
WS_S_ASYNC
 Асинхронная операция по-прежнему находится в состоянии ожидания.

Комментарии

Модуль записи буферизует все данные до вызова WsFlushWriter .

При необходимости необходимо вызвать WsFlushWriter перед WsFreeWriter , чтобы гарантировать выдачу всех данных.

Указав WS_ASYNC_CONTEXT буферизированные данные будут записываться асинхронно.

Эта функция не работает, если модуль записи использует WS_XML_WRITER_BUFFER_OUTPUT.

Если был вызван метод WsWriteStartElement , но элемент не был зафиксирован (см. WsWriteStartElement), этот элемент не будет удален.

Если эта функция вызывается при использовании WS_XML_WRITER_MTOM_ENCODING и в записи отсутствуют открытые элементы, то будут созданы и созданы вспомогательные части MIME. После этого любой API, который пытается выполнить дальнейшую запись в XML-документ, вернет WS_E_INVALID_OPERATION. (См. раздел Возвращаемые значения веб-служб Windows.)

Требования

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