WsReadXmlBufferFromBytes, fonction (webservices.h)
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 |
---|---|
|
Un ou plusieurs arguments ne sont pas valides. |
|
L’opération n’est pas autorisée en raison de l’état actuel de l’objet. |
|
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 |
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour