WsCreateXmlBuffer, fonction (webservices.h)

Article
08/27/2023

Crée une mémoire tampon XML qui peut être utilisée pour traiter des données XML.

Syntaxe

HRESULT WsCreateXmlBuffer(
  [in]           WS_HEAP                      *heap,
                 const WS_XML_BUFFER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
                 WS_XML_BUFFER                **buffer,
  [in, optional] WS_ERROR                     *error
);

Paramètres

[in] heap

Pointeur vers la structure WS_HEAP représentant le tas à partir duquel allouer de la mémoire pour la mémoire tampon XML retournée.

properties

Tableau de structures WS_XML_BUFFER_PROPERTY contenant des propriétés facultatives pour la mémoire tampon XML.

La valeur de ce paramètre peut être NULL, auquel cas le paramètre propertyCount doit être égal à 0 (zéro).

[in] propertyCount

Nombre de propriétés dans le tableau de propriétés .

buffer

En cas de réussite, pointeur qui reçoit l’adresse de l’WS_XML_BUFFER structure représentant la mémoire tampon XML créée. La mémoire de cette mémoire tampon est libérée lorsque son tas est réinitialisé ou libéré.

La mémoire tampon XML est initialement vide.

[in, optional] error

Pointeur vers une structure de WS_ERROR qui reçoit des informations d’erreur supplémentaires en cas d’échec de la fonction.

Valeur retournée

Si la fonction réussit, elle retourne NO_ERROR ; sinon, elle retourne un code d’erreur HRESULT.

Code de retour	Description
E_OUTOFMEMORY	Mémoire insuffisante pour terminer l’opération.
E_INVALIDARG	Un ou plusieurs arguments ne sont pas valides.

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

Share via