WsReadXmlBufferFromBytes, fonction (webservices.h)

Article
03/03/2024

Utilise un lecteur pour convertir un ensemble d’octets encodés en WS_XML_BUFFER.

Syntaxe

HRESULT WsReadXmlBufferFromBytes(
  [in]           WS_XML_READER                *reader,
  [in, optional] const WS_XML_READER_ENCODING *encoding,
                 const WS_XML_READER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
                 const void                   *bytes,
  [in]           ULONG                        byteCount,
  [in]           WS_HEAP                      *heap,
                 WS_XML_BUFFER                **xmlBuffer,
  [in, optional] WS_ERROR                     *error
);

Paramètres

[in] reader

Lecteur à utiliser pour analyser les octets encodés.

[in, optional] encoding

Encodage à utiliser lors de l’analyse des octets. Si la valeur est NULL, une WS_XML_READER_TEXT_ENCODING avec un ensemble de caractères de WS_CHARSET_AUTO sera utilisée.

properties

Tableau de propriétés facultatives du lecteur. Voir WS_XML_READER_PROPERTY.

[in] propertyCount

Nombre de propriétés.

bytes

Octets à analyser.

[in] byteCount

Nombre d’octets à analyser.

[in] heap

Tas à partir duquel allouer la mémoire tampon XML.

xmlBuffer

La mémoire tampon XML dans laquelle les octets ont été lus est retournée ici.

[in, optional] error

Spécifie l’emplacement où les informations d’erreur supplémentaires 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.
WS_E_QUOTA_EXCEEDED	Un quota a été dépassé.

Remarques

La fonction analyse le contenu entier en fonction de l’encodage spécifié et le stocke dans un WS_XML_BUFFER.

Le lecteur sera laissé dans un état non défini après l’appel de cette fonction. Toutefois, WsReadXmlBufferFromBytes peut être utilisé à nouveau avec un tel lecteur. Sinon, WsSetInput ou WsSetInputToBuffer doit être utilisé pour ramener le lecteur à un état connu, ou le lecteur doit être libéré à l’aide de WsFreeReader.

Configuration requise

Condition requise	Valeur
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