WsWriteText, fonction (webservices.h)

Article
08/27/2023

Écrit le texte spécifié dans l’enregistreur XML.

Pour écrire des caractères dans une valeur d’attribut, appelez WsWriteStartAttribute. Seuls les caractères d’espaces blancs 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 WsWriteText(
  [in]           WS_XML_WRITER     *writer,
  [in]           const WS_XML_TEXT *text,
  [in, optional] WS_ERROR          *error
);

Paramètres

[in] writer

Pointeur vers l’objet WS_XML_WRITER dans lequel le texte est écrit. Le pointeur doit référencer un objet Writer XML valide.

[in] text

Pointeur vers le texte à écrire.

Note Pour plus d’informations sur l’objet texte, consultez WS_XML_TEXT et ses classes dérivées.

[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

WsWriteText ne peut être appelé qu’une seule fois entre WsWriteStartAttribute et WsWriteEndAttribute , sauf si le type de texte est l’un des éléments suivants :

WS_XML_TEXT_TYPE_UTF8
WS_XML_TEXT_TYPE_UTF16
WS_XML_TEXT_TYPE_BASE64

Note Si le type de texte est défini sur l’une des valeurs précédentes, WsWriteText peut être appelé plusieurs fois. Toutefois, le type de texte doit être le même pour tous les appels au sein 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