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 错误代码。

注解

Windows Web 服务 API 中的堆是用于 消息的内存分配。 堆还可用于独立于消息生存期存储消息数据。 某些 API 函数允许对读取的任何数据的生存期进行显式堆控制。

创建新堆不会分配任何内存 (，但 WS_HEAP 结构本身) 所需的内存除外。 maxSize 和 trimSize 参数仅用作 WsAlloc 和 WsResetHeap 操作的配额。

要求

要求 值
最低受支持的客户端 Windows 7 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2 [桌面应用 |UWP 应用]
目标平台 Windows
标头 webservices.h
Library WebServices.lib
DLL WebServices.dll