Compartilhar via

Função WsFlushWriter (webservices.h)

  • Artigo

Instrui o gravador a invocar o retorno de chamada especificado em WS_XML_WRITER_STREAM_OUTPUT se dados suficientes tiverem sido armazenados em buffer.

Sintaxe

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

Parâmetros

[in] writer

O gravador a ser liberado.

[in] minSize

Especifica o número mínimo de bytes que devem ser armazenados em buffer para que o retorno de chamada seja invocado. Se menos de esse número de bytes forem armazenados em buffer, o retorno de chamada não será invocado. Isso pode ser usado para minimizar o número de e/s que ocorrem ao gravar pequenas quantidades de dados.

Zero deve ser especificado para garantir que o retorno de chamada seja invocado.

[in, optional] asyncContext

Informações sobre como invocar a função de forma assíncrona ou NULL se estiver invocando de forma síncrona.

[in, optional] error

Especifica onde informações adicionais de erro devem ser armazenadas se a função falhar.

Valor retornado

Essa função pode retornar um desses valores.

Código de retorno Descrição
E_INVALIDARG
 Um ou mais argumentos são inválidos.
WS_S_ASYNC
 A operação assíncrona ainda está pendente.

Comentários

O gravador armazena todos os dados em buffer até que WsFlushWriter seja chamado.

Se necessário, o WsFlushWriter deve ser chamado antes de WsFreeWriter para garantir que todos os dados sejam emitidos.

Ao especificar um WS_ASYNC_CONTEXT os dados armazenados em buffer serão gravados de forma assíncrona.

Essa função será não operacional se o gravador estiver usando WS_XML_WRITER_BUFFER_OUTPUT.

Se WsWriteStartElement tiver sido chamado, mas o elemento não tiver sido confirmado (consulte WsWriteStartElement), esse elemento não será liberado.

Se essa função for chamada ao usar WS_XML_WRITER_MTOM_ENCODING e não houver elementos abertos no gravador, as partes MIME de suporte serão geradas e emitidas. Depois que isso ocorrer, qualquer API que tentar gravar mais no documento XML retornará WS_E_INVALID_OPERATION. (Consulte Valores retornados dos Serviços Web do Windows.)

Requisitos

   
Cliente mínimo com suporte Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho webservices.h
Biblioteca WebServices.lib
DLL WebServices.dll