Función WsSetOutput (webservices.h)

Establece las devoluciones de llamada de codificación y salida para el escritor. Las devoluciones de llamada se usan para proporcionar búferes al escritor y para realizar E/S asincrónicas.

Sintaxis

HRESULT WsSetOutput(
  [in]           WS_XML_WRITER                *writer,
  [in, optional] const WS_XML_WRITER_ENCODING *encoding,
  [in, optional] const WS_XML_WRITER_OUTPUT   *output,
                 const WS_XML_WRITER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
  [in, optional] WS_ERROR                     *error
);

Parámetros

[in] writer

Escritor para el que se establecerá la salida.

[in, optional] encoding

La codificación describe el formato de los bytes de entrada. Debe ser uno de WS_XML_WRITER_TEXT_ENCODING, WS_XML_WRITER_BINARY_ENCODING o WS_XML_WRITER_MTOM_ENCODING.

[in, optional] output

Especifica dónde debe colocar el escritor sus datos.

properties

Matriz de propiedades opcionales del escritor. Consulte WS_XML_WRITER_PROPERTY.

[in] propertyCount

Número de propiedades.

[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

Cuando se usa WsSetOutput en el sistema de escritura, el escritor funcionará solo de forma directa y las funciones WsGetWriterPosition, WsSetWriterPosition y WsMoveWriter no se pueden usar.

Si la codificación es NULL, se omite WS_XML_WRITER_OUTPUT y se configura el sistema de escritura para que se produzca un error en cualquier intento de escritura en él.

Si la codificación no es NULL, WS_XML_WRITER_OUTPUT también debe ser distinto de NULL .

Si WS_XML_WRITER_OUTPUT se WS_XML_WRITER_BUFFER_OUTPUT , el escritor almacenará en búfer los bytes generados del documento. Use WsGetWriterProperty con WS_XML_WRITER_PROPERTY_BUFFERS o WS_XML_WRITER_PROPERTY_BYTES para obtener estos bytes. En este modo WsFlushWriter no tiene ningún efecto.

Si WS_XML_WRITER_OUTPUT es WS_XML_WRITER_STREAM_OUTPUT , el escritor pasará los bytes generados del documento al WS_WRITE_CALLBACK especificado durante las llamadas a WsFlushWriter.

El escritor se inicializará para usar las propiedades especificadas en WsCreateWriter. Las propiedades especificadas en WsSetOutput invalidarán esas propiedades.

Vea WsCreateWriter para conocer los valores predeterminados de las propiedades del escritor.

Requisitos