WsWriteBytes, fonction (webservices.h)

  • Article

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

Code de retour Description
E_INVALIDARG
 Un ou plusieurs arguments ne sont pas valides.
WS_E_INVALID_OPERATION
 L’opération n’est pas autorisée en raison de l’état actuel de l’objet.
WS_E_QUOTA_EXCEEDED
 Un quota a été dépassé.

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

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