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.

Código devuelto	Descripción
E_INVALIDARG	Uno o más argumentos no son válidos.
WS_E_INVALID_OPERATION	No se permite la operación debido al estado actual del objeto .
WS_E_QUOTA_EXCEEDED	Se superó una cuota.

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

Requisito	Value
Cliente mínimo compatible	Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	webservices.h
Library	WebServices.lib
Archivo DLL	WebServices.dll