WsWriteBytes, fonction (webservices.h)

Écrit des octets dans l’enregistreur dans un format optimisé pour l’encodage. Lors de l’écriture dans un encodage de texte, il émet les octets encodés en base64. Lors de l’écriture dans un format binaire, il émet directement les octets.

Syntaxe

HRESULT WsWriteBytes(
  [in]           WS_XML_WRITER *writer,
                 const void    *bytes,
  [in]           ULONG         byteCount,
  [in, optional] WS_ERROR      *error
);

Paramètres

[in] writer

Enregistreur dans lequel les octets seront écrits.

bytes

Octets à écrire dans le document.

[in] byteCount

Nombre d’octets à écrire dans le document.

[in, optional] error

Spécifie l’emplacement où les informations d’erreur supplémentaires doivent être stockées en cas d’échec de la fonction.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Remarques

WsWriteBytes peut être appelé plusieurs fois entre WsWriteStartAttribute et WsWriteEndAttribute. Il ne peut pas être combiné avec WsWriteChars, WsWriteCharsUtf8, WsWriteValue ou WsWriteText lors de l’écriture d’un attribut.

Pour le WS_XML_WRITER_MTOM_ENCODING, si byteCount dépasse le maxInlineByteCount spécifié pendant WsSetOutput , les octets seront mis en mémoire tampon et placés dans leur propre partie MIME. Sinon, les octets sont encodés en base64 et placés directement dans le document.

Pour le WS_XML_WRITER_MTOM_ENCODING, si l’élément contenant les octets a un attribut portant le nom « contentType » et l’espace de noms « »,http://www.w3.org/2004/11/xmlmime la valeur de l’attribut est reflétée dans l’en-tête de type de contenu pour le composant MIME, comme décrit dans Empaquetage optimisé XML-binary.

Configuration requise