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.

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 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

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