WsResetHeap 函数 (webservices.h)

释放所有堆分配。使用 WsAlloc 对堆进行的分配不再有效。不会释放堆对象本身的分配。

语法

HRESULT WsResetHeap(
  [in]           WS_HEAP  *heap,
  [in, optional] WS_ERROR *error
);

[in] heap

指向要重置的堆实例的指针。如果给定类型不需要堆，则此参数可以为 NULL。

堆对象。

[in, optional] error

指向 WS_ERROR 对象的指针，如果函数失败，应存储有关错误的其他信息。

如果此函数成功，则返回 S_OK。否则，将返回 HRESULT 错误代码。

堆对象即使已重置，也可以保留分配的内存。创建堆时，可以使用 WS_HEAP_PROPERTY_TRIM_SIZE 属性指定保留的内存量。