Expand Minimize

WsCreateXmlBuffer function

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

Syntax


HRESULT WINAPI  WsCreateXmlBuffer(
  _In_      WS_HEAP* heap,
  const WS_XML_BUFFER_PROPERTY* properties,
  _In_      ULONG propertyCount,
  WS_XML_BUFFER** buffer,
  _In_opt_  WS_ERROR* error
);

Parameters

heap [in]

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).

propertyCount [in]

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.

error [in, optional]

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.

Return codeDescription
E_OUTOFMEMORY

Insufficient memory to complete the operation.

E_INVALIDARG

One or more arguments are invalid.

 

Requirements

Minimum supported client

Windows 7 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2008 R2 [desktop apps | Windows Store apps]

Header

WebServices.h

Library

WebServices.lib

DLL

WebServices.dll

 

 

Community Additions

ADD
Show:
© 2014 Microsoft