Partager via


WsCreateXmlBuffer, fonction (webservices.h)

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