WsResetHeap-Funktion (webservices.h)

Gibt alle Heap-Zuordnungen frei. Zuordnungen, die auf dem Heap mit WsAlloc vorgenommen wurden, sind nicht mehr gültig. Die Zuordnung für das Heap-Objekt selbst wird nicht freigegeben.

Syntax

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

Parameter

[in] heap

Ein Zeiger auf einen zurückzusetzenden Heap-instance. Wenn der Heap für den angegebenen Typ nicht erforderlich ist, kann dieser Parameter NULL sein.

Das Heapobjekt.

[in, optional] error

Ein Zeiger auf ein WS_ERROR-Objekt , in dem zusätzliche Informationen zum Fehler gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Das Heapobjekt kann zugeordneten Arbeitsspeicher beibehalten, obwohl es zurückgesetzt wurde. Die Menge des beibehaltenen Arbeitsspeichers kann beim Erstellen des Heaps mithilfe der eigenschaft WS_HEAP_PROPERTY_TRIM_SIZE angegeben werden.

Anforderungen