Funzione WsCreateXmlBuffer (webservices.h)

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.

Requisiti