WsWriteCharsUtf8, fonction (webservices.h)

Article
08/27/2023

Écrit une série de caractères encodés en UTF-8 dans un élément ou un attribut. Pour écrire des caractères dans une valeur d’attribut, appelez d’abord WsWriteStartAttribute . Seuls les caractères d’espace blanc peuvent être écrits à la racine d’un document xml, sauf si le WS_XML_WRITER_PROPERTY_ALLOW_FRAGMENT a été défini sur TRUE.

Syntaxe

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

Paramètres

[in] writer

Pointeur vers l’objet WS_XML_WRITER dans lequel les caractères sont écrits. Le pointeur doit référencer un objet Writer XML valide.

bytes

Pointeur vers les caractères UTF-8 encodés à écrire.

[in] byteCount

Nombre d'octets à écrire.

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

Remarques

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

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

Partager via