Funzione WsCreateXmlBuffer (webservices.h)

Articolo
08/27/2023

Crea un buffer XML che può essere utilizzato per elaborare i dati XML.

Sintassi

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

Parametri

[in] heap

Puntatore alla struttura WS_HEAP che rappresenta l'heap da cui allocare memoria per il buffer XML restituito.

properties

Matrice di strutture WS_XML_BUFFER_PROPERTY contenenti proprietà facoltative per il buffer XML.

Il valore di questo parametro può essere NULL, nel qual caso il parametro propertyCount deve essere 0 (zero).

[in] propertyCount

Numero di proprietà nella matrice delle proprietà .

buffer

In caso di esito positivo, un puntatore che riceve l'indirizzo della struttura WS_XML_BUFFER che rappresenta il buffer XML creato. La memoria per questo buffer viene rilasciata quando il relativo heap viene reimpostato o rilasciato.

Il buffer XML è inizialmente vuoto.

[in, optional] error

Puntatore a una struttura WS_ERROR che riceve informazioni aggiuntive sull'errore se la funzione ha esito negativo.

Valore restituito

Se la funzione ha esito positivo, restituisce NO_ERROR; in caso contrario, restituisce un codice di errore HRESULT.

Codice restituito	Descrizione
E_OUTOFMEMORY	Memoria insufficiente per completare l'operazione.
E_INVALIDARG	Uno o più argomenti non sono validi.

Requisiti


Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	webservices.h
Libreria	WebServices.lib
DLL	WebServices.dll

Condividi tramite