WsWriteValue, fonction (webservices.h)

Article
08/27/2023

Cette opération dérive la meilleure représentation d’une valeur primitive à partir de l’encodage sous-jacent et transmet la valeur dérivée à un objet Writer.

Note Il est généralement plus efficace d’utiliser cette fonction pour écrire des valeurs primitives plutôt que de convertir la valeur en texte et d’utiliser ensuite WsWriteChars.

Syntaxe

HRESULT WsWriteValue(
  [in]           WS_XML_WRITER *writer,
  [in]           WS_VALUE_TYPE valueType,
                 const void    *value,
  [in]           ULONG         valueSize,
  [in, optional] WS_ERROR      *error
);

Paramètres

[in] writer

Pointeur vers l’objet WS_XML_WRITER dans lequel la valeur est écrite. Le pointeur doit référencer un objet Writer XML valide.

[in] valueType

Indique le type de valeur primitive référencée par le paramètre value .

value

Pointeur void vers la valeur primitive.

[in] valueSize

Taille en octets de la valeur en cours d’écriture.

[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

WsWriteValue ne peut être appelé qu’une seule fois entre WsWriteStartAttribute et WsWriteEndAttribute. Il ne peut pas être combiné avec WsWriteChars, WsWriteBytes, WsWriteCharsUtf8 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