Función WsWriteBytes (webservices.h)

Escribe bytes en el escritor en un formato optimizado para la codificación. Al escribir en una codificación de texto, emitirá los bytes codificados en base64. Al escribir en un formato binario, emitirá los bytes directamente.

Sintaxis

HRESULT WsWriteBytes(
  [in]           WS_XML_WRITER *writer,
                 const void    *bytes,
  [in]           ULONG         byteCount,
  [in, optional] WS_ERROR      *error
);

Parámetros

[in] writer

Escritor en el que se escribirán los bytes.

bytes

Bytes que se van a escribir en el documento.

[in] byteCount

Número de bytes que se van a escribir en el documento.

[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

Se puede llamar a WsWriteBytes más de una vez entre WsWriteStartAttribute y WsWriteEndAttribute. No se puede combinar con WsWriteChars, WsWriteCharsUtf8, WsWriteValue o WsWriteText al escribir un atributo.

Para el WS_XML_WRITER_MTOM_ENCODING, si el byteCount supera el valor maxInlineByteCount especificado durante WsSetOutput , los bytes se almacenarán en búfer y se colocarán en su propia parte MIME. De lo contrario, los bytes se codifican en base64 y se colocan directamente en el documento.

Para el WS_XML_WRITER_MTOM_ENCODING, si el elemento que contiene los bytes tiene un atributo con el nombre "contentType" y el espacio de nombres "http://www.w3.org/2004/11/xmlmime", el valor del atributo se reflejará en el encabezado de tipo de contenido para el elemento MIME, tal y como se describe en Empaquetado optimizado binario XML.

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