Función WsReadXmlBufferFromBytes (webservices.h)

Usa un lector para convertir un conjunto de bytes codificados en un WS_XML_BUFFER.

Sintaxis

HRESULT WsReadXmlBufferFromBytes(
  [in]           WS_XML_READER                *reader,
  [in, optional] const WS_XML_READER_ENCODING *encoding,
                 const WS_XML_READER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
                 const void                   *bytes,
  [in]           ULONG                        byteCount,
  [in]           WS_HEAP                      *heap,
                 WS_XML_BUFFER                **xmlBuffer,
  [in, optional] WS_ERROR                     *error
);

Parámetros

[in] reader

Lector que se va a usar para analizar los bytes codificados.

[in, optional] encoding

Codificación que se va a usar al analizar los bytes. Si es NULL, se usará un WS_XML_READER_TEXT_ENCODING con un conjunto de caracteres de WS_CHARSET_AUTO .

properties

Matriz de propiedades opcionales del lector. Consulte WS_XML_READER_PROPERTY.

[in] propertyCount

Número de propiedades.

bytes

Bytes que se van a analizar.

[in] byteCount

Número de bytes que se van a analizar.

[in] heap

Montón desde el que se va a asignar el búfer XML.

xmlBuffer

El búfer XML en el que se leyeron los bytes 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 analizará todo el contenido según la codificación especificada y la almacenará en un WS_XML_BUFFER.

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

Requisitos