Função WsResetHeap (webservices.h)

  • Artigo

Libera todas as alocações de Heap. As alocações feitas no Heap usando WsAlloc não são mais válidas. A alocação para o próprio objeto Heap não é liberada.

Sintaxe

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

Parâmetros

[in] heap

Um ponteiro para uma instância do Heap a ser redefinida. Se o heap não for necessário para o tipo fornecido, esse parâmetro poderá ser NULL.

O objeto heap.

[in, optional] error

Um ponteiro para um objeto WS_ERROR em que informações adicionais sobre o erro devem ser armazenadas se a função falhar.

Valor retornado

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O objeto heap pode reter a memória alocada mesmo que tenha sido redefinido. A quantidade de memória retida pode ser especificada usando a propriedade WS_HEAP_PROPERTY_TRIM_SIZE ao criar o heap.

Requisitos

   
Cliente mínimo com suporte Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho webservices.h
Biblioteca WebServices.lib
DLL WebServices.dll