Función WsWriteXmlBufferToBytes (webservices.h)

Usa un escritor para convertir un WS_XML_BUFFER en un conjunto codificado de bytes.

Sintaxis

HRESULT WsWriteXmlBufferToBytes(
  [in]           WS_XML_WRITER                *writer,
  [in]           WS_XML_BUFFER                *xmlBuffer,
  [in, optional] const WS_XML_WRITER_ENCODING *encoding,
                 const WS_XML_WRITER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
  [in]           WS_HEAP                      *heap,
                 void                         **bytes,
  [out]          ULONG                        *byteCount,
  [in, optional] WS_ERROR                     *error
);

Parámetros

[in] writer

Escritor que se va a usar para generar los bytes codificados.

[in] xmlBuffer

Búfer XML que se va a escribir.

[in, optional] encoding

Codificación que se va a usar al generar los bytes. Si es NULL, los bytes se codificarán en utf8.

properties

Matriz de propiedades opcionales del escritor. Consulte WS_XML_WRITER_PROPERTY.

[in] propertyCount

Número de propiedades.

[in] heap

Montón desde el que se van a asignar los bytes.

bytes

Los bytes generados se devuelven aquí.

[out] byteCount

El número de bytes generados se devuelve aquí.

[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

La función generará todo el contenido del WS_XML_BUFFER como un conjunto lineal de bytes asignados desde el montón especificado en la codificación especificada.

El escritor se dejará en un estado indefinido después de llamar a esta función. Sin embargo, WsWriteXmlBufferToBytes se puede usar de nuevo con este tipo de escritor. De lo contrario, WsSetOutput o WsSetOutputToBuffer deben usarse para devolver el escritor a un estado conocido o el escritor debe liberarse mediante WsFreeWriter.

Requisitos