WsReadChars, fonction (webservices.h)

Article
08/27/2023

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

Partager via