Función WsFlushWriter (webservices.h)

Indica al escritor que invoque la devolución de llamada especificada en WS_XML_WRITER_STREAM_OUTPUT si se han almacenado en búfer suficientes datos.

Sintaxis

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

Escritor que se va a vaciar.

[in] minSize

Especifica el número mínimo de bytes que se deben almacenar en búfer para que se invoque la devolución de llamada . Si se almacenan en búfer menos de este número de bytes, no se invocará la devolución de llamada . Esto se puede usar para minimizar el número de E/S que se producen al escribir pequeñas cantidades de datos.

Se debe especificar cero para garantizar que se invoca la devolución de llamada .

[in, optional] asyncContext

Información sobre cómo invocar la función de forma asincrónica o NULL si invoca de forma sincrónica.

[in, optional] error

Especifica dónde se debe almacenar información de error adicional si se produce un error en la función.

Valor devuelto

Esta función puede devolver uno de estos valores.

Comentarios

El escritor almacena en búfer todos los datos hasta que se llama a WsFlushWriter .

Si es necesario, se debe llamar a WsFlushWriter antes de que WsFreeWriter garantice que se emita todos los datos.

Al especificar un WS_ASYNC_CONTEXT los datos almacenados en búfer se escribirán de forma asincrónica.

Esta función es una operación no operativa si el escritor usa WS_XML_WRITER_BUFFER_OUTPUT.

Si se ha llamado a WsWriteStartElement , pero no se ha confirmado el elemento (vea WsWriteStartElement), este elemento no se vaciará.

Si se llama a esta función al usar WS_XML_WRITER_MTOM_ENCODING y no hay elementos abiertos en el sistema de escritura, se generarán y emitirán los elementos MIME auxiliares. Una vez que esto ocurra, cualquier API que intente escribir más en el documento XML devolverá WS_E_INVALID_OPERATION. (Consulte Valores devueltos de servicios web de Windows).

Requisitos