Macro GlobalDiscard (winbase.h)

  • Artigo

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

Nota As funções globais 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 global deve ser usada. Para obter mais informações, consulte Funções globais e locais.
 

Sintaxe

void GlobalDiscard(
  [in]  h
);

Parâmetros

[in] h

Um identificador para o objeto de memória global. Esse identificador é retornado pela função GlobalAlloc ou GlobalReAlloc .

Valor retornado

Nenhum

Comentários

Embora GlobalDiscard descarte o bloco de memória do objeto, o identificador para o objeto permanece válido. O processo pode, posteriormente, passar o identificador para a função GlobalReAlloc para alocar outro bloco de memória global identificado pelo mesmo identificador.

Requisitos

   
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 winbase.h (incluir Windows.h)

Confira também

Funções globais e locais

Globalalloc

GlobalReAlloc

Funções de gerenciamento da memória