Funzione WsResetHeap (webservices.h)

Articolo
08/27/2023

Rilascia tutte le allocazioni di Heap. Le allocazioni effettuate nell'Heap usando WsAlloc non sono più valide. L'allocazione per l'oggetto Heap stesso non viene rilasciata.

Sintassi

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

Parametri

[in] heap

Puntatore a un'istanza di Heap da reimpostare. Se l'heap non è obbligatorio per il tipo specificato, questo parametro può essere NULL.

Oggetto heap.

[in, optional] error

Puntatore a un oggetto WS_ERROR in cui devono essere archiviate informazioni aggiuntive sull'errore se la funzione ha esito negativo.

Valore restituito

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

L'oggetto heap può conservare la memoria allocata anche se è stata reimpostata. La quantità di memoria mantenuta può essere specificata usando la proprietà WS_HEAP_PROPERTY_TRIM_SIZE durante la creazione dell'heap.

Requisiti


Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	webservices.h
Libreria	WebServices.lib
DLL	WebServices.dll