WsCreateXmlBuffer function (webservices.h)

Creates an XML Buffer which can be used to process XML data .

Syntax

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

Parameters

[in] heap

Pointer to the WS_HEAP structure representing the heap from which to allocate memory for the returned XML buffer.

properties

An array of WS_XML_BUFFER_PROPERTY structures containing optional properties for the XML buffer.

The value of this parameter may be NULL, in which case, the propertyCount parameter must be 0 (zero).

[in] propertyCount

The number of properties in the properties array.

buffer

On success, a pointer that receives the address of the WS_XML_BUFFER structure representing the created XML buffer. The memory for this buffer is released when its heap is reset or released.

The XML buffer is initially empty.

[in, optional] error

Pointer to a WS_ERROR structure that receives additional error information if the function fails.

Return value

If the function succeeds, it returns NO_ERROR; otherwise, it returns an HRESULT error code.

Requirements