WsReadCharsUtf8, fonction (webservices.h)

Lit un nombre spécifié de caractères de texte à partir du lecteur et les retourne encodés en UTF-8.

Syntaxe

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

Paramètres

[in] reader

Pointeur vers le lecteur XML à partir duquel les données de caractères doivent être lues. Le pointeur doit référencer un objet WS_XML_READER valide.

bytes

Pointeur vers la mémoire tampon pour placer les octets encodés qui ont été lus.

[in] maxByteCount

Nombre maximal d’octets à lire.

[out] actualByteCount

Pointeur vers une valeur ULONG du nombre réel d’octets qui ont été lus. Cela peut être inférieur à maxByteCount, même s’il reste plus d’octets. Il n’y a plus d’octets quand cela retourne zéro.

[in, optional] error

Pointeur vers un objet WS_ERROR où des informations supplémentaires sur l’erreur doivent être stockées en cas d’échec de la fonction.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Remarques

Le texte XML est lu jusqu’à un élément de début ou à un élément de fin. Les commentaires sont ignorés et le contenu CDATA est traité de la même manière que le contenu de l’élément. Les entités de caractères sont converties dans leur forme sans séquence d’échappement.

Cette fonction peut échouer pour l’une des raisons répertoriées dans WsReadNode.

Configuration requise