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

Статья
08/27/2023

Создает буфер 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

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