Función WsReadCharsUtf8 (webservices.h)

  • Artículo

Lee un número especificado de caracteres de texto del lector y los devuelve codificados en UTF-8.

Sintaxis

HRESULT WsReadCharsUtf8(
  [in]           WS_XML_READER *reader,
                 BYTE          *bytes,
  [in]           ULONG         maxByteCount,
  [out]          ULONG         *actualByteCount,
  [in, optional] WS_ERROR      *error
);

Parámetros

[in] reader

Puntero al lector XML desde el que se deben leer los datos de caracteres. El puntero debe hacer referencia a un objeto WS_XML_READER válido.

bytes

Puntero al búfer para colocar los bytes codificados que se han leído.

[in] maxByteCount

Número máximo de bytes que se deben leer.

[out] actualByteCount

Puntero a un valor ULONG del número real de bytes leídos. Puede ser menor que maxByteCount incluso cuando quedan más bytes. No hay más bytes cuando devuelve cero.

[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
WS_E_INVALID_FORMAT
 Los datos de entrada no tenían el formato esperado o no tenían el valor esperado.
WS_E_QUOTA_EXCEEDED
 Se superó una cuota.

Comentarios

El texto XML se lee hasta un elemento start o end. Los comentarios se omiten y el contenido de CDATA se trata de forma idéntica al contenido del elemento. Las entidades de caracteres se convierten en su forma sin escape.

Esta función puede producir un error por cualquiera de los motivos enumerados en WsReadNode.

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