Função FreeResource (libloaderapi.h)

Artigo
02/28/2024

Observação

Essa função é obsoleta e só tem suporte para compatibilidade com versões anteriores com o Windows de 16 bits. Para aplicativos windows de 32 bits, não é necessário liberar os recursos carregados usando LoadResource. Para versões modernas do Windows, essa função sempre retorna FALSE.

Diminui (diminui em um) a contagem de referência de um recurso carregado. Quando a contagem de referência atinge zero, a memória ocupada pelo recurso é liberada.

Sintaxe

BOOL FreeResource(
  [in] HGLOBAL hResData
);

Parâmetros

[in] hResData

Tipo: HGLOBAL

Um identificador do recurso. Supõe-se que hglbResource foi criado pelo LoadResource.

Retornar valor

Tipo: BOOL

Se a função obtiver êxito, o valor retornado será zero.

Se a função falhar, o valor retornado será diferente de zero, o que indica que o recurso não foi liberado.

Comentários

Para recursos carregados com outras funções, FreeResource foi substituído pelas seguintes funções:

Tipo de recurso	Substituição de FreeResource
Acelerador	DestroyAcceleratorTable
Bitmap	DeleteObject
Cursor	DestroyCursor
ícone	Destroyicon
Menu	Destroymenu

A contagem de referência para um recurso é incrementada (aumentada em um) sempre que um aplicativo chama a função LoadResource para o recurso.

O sistema exclui automaticamente esses recursos quando o processo que os criou é encerrado. No entanto, chamar a função apropriada salva a memória. Para obter mais informações, consulte LoadResource.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	libloaderapi.h (inclua Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll