Macro LocalDiscard (minwinbase.h)

  • Artigo

Descarta o objeto de memória local especificado. A contagem de bloqueios do objeto de memória deve ser zero.

Nota As funções locais têm maior sobrecarga e fornecem menos recursos do que outras funções de gerenciamento de memória. Novos aplicativos devem usar as funções heap , a menos que a documentação declare que uma função local deve ser usada. Para obter mais informações, consulte Funções globais e locais.
 

Sintaxe

void LocalDiscard(
  [in]  h
);

Parâmetros

[in] h

Um identificador para o objeto de memória local. Esse identificador é retornado pela função LocalAlloc ou LocalReAlloc .

Retornar valor

Nenhum

Comentários

Embora LocalDiscard descarte o bloco de memória do objeto, o identificador para o objeto permanece válido. Um processo pode, posteriormente, passar o identificador para a função LocalReAlloc para alocar outro objeto de memória local identificado pelo mesmo identificador.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho minwinbase.h (inclua Windows.h)

Confira também

Funções globais e locais

Localalloc

Localrealloc

Funções de gerenciamento da memória