Función WsWriteCharsUtf8 (webservices.h)

Escribe una serie de caracteres codificados como UTF-8 en un elemento o atributo. Para escribir caracteres en un valor de atributo, llame primero a WsWriteStartAttribute . Solo se pueden escribir caracteres de espacio en blanco en la raíz de un documento xml a menos que el WS_XML_WRITER_PROPERTY_ALLOW_FRAGMENT se haya establecido en TRUE.

Sintaxis

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

Parámetros

[in] writer

Puntero al objeto WS_XML_WRITER en el que se escriben los caracteres. El puntero debe hacer referencia a un objeto xml Writer válido.

bytes

Puntero a los caracteres UTF-8 codificados que se van a escribir.

[in] byteCount

Número de bytes que se van a escribir.

[in, optional] error

Puntero a un objeto WS_ERROR donde se debe almacenar información adicional sobre el error 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 .

Comentarios

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

Requisitos

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