WsWriteChars, fonction (webservices.h)

Article
08/27/2023

É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

Partager via