Поделиться через


Функция WsCreateXmlBuffer (webservices.h)

Создает буфер XML , который можно использовать для обработки XML-данных.

Синтаксис

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

Параметры

[in] heap

Указатель на структуру WS_HEAP , представляющую кучу , из которой выделяется память для возвращаемого XML-буфера.

properties

Массив WS_XML_BUFFER_PROPERTY структур, содержащих необязательные свойства для XML-буфера.

Значение этого параметра может иметь значение NULL. В этом случае параметр propertyCount должен иметь значение 0 (ноль).

[in] propertyCount

Количество свойств в массиве свойств .

buffer

При успешном выполнении указатель получает адрес структуры WS_XML_BUFFER , представляющей созданный буфер XML. Память для этого буфера освобождается при сбросе или освобождении кучи.

Изначально буфер XML пуст.

[in, optional] error

Указатель на структуру WS_ERROR , которая получает дополнительные сведения об ошибке в случае сбоя функции.

Возвращаемое значение

Если функция завершается успешно, она возвращает NO_ERROR; в противном случае возвращается код ошибки HRESULT.

Код возврата Описание
E_OUTOFMEMORY
Недостаточно памяти для завершения операции.
E_INVALIDARG
Один или несколько аргументов являются недопустимыми.

Требования

   
Минимальная версия клиента Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header webservices.h
Библиотека WebServices.lib
DLL WebServices.dll