Lire en anglais

Partager via


WsWriteChars, fonction (webservices.h)

Écrit une série de caractères 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 WsWriteChars(
  [in]           WS_XML_WRITER *writer,
                 const WCHAR   *chars,
  [in]           ULONG         charCount,
  [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.

chars

Pointeur vers les caractères à écrire.

[in] charCount

Nombre de caractères à é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

WsWriteChars peut être appelé plusieurs fois entre WsWriteStartAttribute et WsWriteEndAttribute. Il ne peut pas être combiné avec WsWriteCharsUtf8, 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