WsReadBytes, fonction (webservices.h)

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.

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