Macro GlobalDiscard (winbase.h)
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) |