Função LocalFree (winbase.h)

Artigo
08/27/2023

Libera o objeto de memória local especificado e invalida seu identificador.

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

HLOCAL LocalFree(
  [in] _Frees_ptr_opt_ HLOCAL hMem
);

Parâmetros

[in] hMem

Um identificador para o objeto de memória local. Esse identificador é retornado pela função LocalAlloc ou LocalReAlloc . Não é seguro liberar memória alocada com GlobalAlloc.

Valor retornado

Se a função for bem-sucedida, o valor retornado será NULL.

Se a função falhar, o valor retornado será igual a um identificador para o objeto de memória local. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Se o processo tentar examinar ou modificar a memória depois que ela tiver sido liberada, poderá ocorrer corrupção de heap ou uma exceção de violação de acesso (EXCEPTION_ACCESS_VIOLATION) poderá ser gerada.

Se o parâmetro hMem for NULL, LocalFree ignorará o parâmetro e retornará NULL.

A função LocalFree liberará um objeto de memória bloqueado. Um objeto de memória bloqueada tem uma contagem de bloqueio maior que zero. A função LocalLock bloqueia um objeto de memória local e incrementa a contagem de bloqueios em um. A função LocalUnlock a desbloqueia e diminui a contagem de bloqueios em um. Para obter a contagem de bloqueios de um objeto de memória local, use a função LocalFlags .

Se um aplicativo estiver em execução em uma versão de depuração do sistema, LocalFree emitirá uma mensagem informando que um objeto bloqueado está sendo liberado. Se você estiver depurando o aplicativo, LocalFree entrará em um ponto de interrupção pouco antes de liberar um objeto bloqueado. Isso permite que você verifique o comportamento pretendido e continue a execução.

Exemplos

Para obter um exemplo, consulte LocalAlloc.

Requisitos


Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho \| aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	winbase.h (incluir Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll