WsReadBytes, fonction (webservices.h)

  • Article

Lit le texte du lecteur et décode les caractères en octets conformément à la spécification base64.

Syntaxe

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

Paramètres

[in] reader

Pointeur vers le lecteur XML à partir duquel les octets doivent être lus. Le pointeur doit référencer un objet WS_XML_READER valide.

bytes

Pointeur vers un emplacement pour placer les octets décodés.

[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.

[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.

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

Configuration requise

   
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