WsReadChars, fonction (webservices.h)

  • Article

Lit un nombre spécifié de caractères de texte à partir du lecteur.

Syntaxe

HRESULT WsReadChars(
  [in]           WS_XML_READER *reader,
                 WCHAR         *chars,
  [in]           ULONG         maxCharCount,
  [out]          ULONG         *actualCharCount,
  [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.

chars

Pointeur vers un emplacement pour les caractères qui ont été lus.

[in] maxCharCount

Nombre maximal de caractères à lire.

[out] actualCharCount

Pointeur vers une valeur ULONG du nombre réel de caractères lus. Cela peut être inférieur à maxCharCount même s’il reste plus de caractères. Il n’y a plus de caractères 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.

Code de retour Description
WS_E_INVALID_FORMAT
 Les données d’entrée n’étaient pas au format attendu ou n’avaient pas la valeur attendue.
WS_E_QUOTA_EXCEEDED
 Un quota a été dépassé.

Remarques

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

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête webservices.h
Bibliothèque WebServices.lib
DLL WebServices.dll