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

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

  • Статья

Создает объект кучи .

Синтаксис

HRESULT WsCreateHeap(
  [in]           SIZE_T                 maxSize,
  [in]           SIZE_T                 trimSize,
  [in, optional] const WS_HEAP_PROPERTY *properties,
  [in]           ULONG                  propertyCount,
                 WS_HEAP                **heap,
  [in, optional] WS_ERROR               *error
);

Параметры

[in] maxSize

Общее количество байтов, которые можно выделить из кучи. Общее число байтов определяется как сумма размеров, переданных во всех вызовах функции WsAlloc с момента создания или сброса кучи.

[in] trimSize

Максимальное количество байтов памяти, которое сохраняется в куче после сброса кучи путем вызова функции WsResetHeap . Это приблизительное значение из-за накладных расходов на кучу.

Примечание Если значение trimSize больше значения maxSize, размер кучи не будет скорректирован в соответствии с нужным размером.

 

[in, optional] properties

Зарезервировано для использования в будущем; для параметра задано значение NULL.

[in] propertyCount

Зарезервировано для использования в будущем; значение 0 (ноль).

heap

При успешном выполнении указатель, который получает адрес WS_HEAP структуры, представляющей новый объект кучи.

[in, optional] error

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

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

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

Комментарии

Куча в API веб-служб Windows — это выделение памяти, используемое для сообщений. Кучи также можно использовать для хранения данных сообщений отдельно от времени существования сообщения. Некоторые функции API обеспечивают явное управление кучей в течение времени существования любых считываемых данных.

При создании кучи не выделяется память (за исключением памяти, необходимой для WS_HEAP самой структуры). Параметры maxSize и trimSize используются в качестве квот только для операций WsAlloc и WsResetHeap .

Требования

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