WsResetHeap, fonction (webservices.h)

Libère toutes les allocations de tas. Les allocations effectuées sur le tas à l’aide de WsAlloc ne sont plus valides. L’allocation pour l’objet Tas lui-même n’est pas libérée.

Syntaxe

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

Paramètres

[in] heap

Pointeur vers un tas instance à réinitialiser. Si le tas n’est pas requis pour le type donné, ce paramètre peut être NULL.

Objet tas.

[in, optional] error

Pointeur vers un objet WS_ERROR où des informations supplémentaires sur l’erreur doivent être stockées en cas d’échec de la fonction.

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

L’objet tas peut conserver la mémoire allouée même s’il a été réinitialisé. La quantité de mémoire conservée peut être spécifiée à l’aide de la propriété WS_HEAP_PROPERTY_TRIM_SIZE lors de la création du tas.

Configuration requise