Función FreeResource (libloaderapi.h)

Artículo
02/28/2024

Nota

Esta función está obsoleta y solo se admite para la compatibilidad con versiones anteriores con Windows de 16 bits. En el caso de las aplicaciones windows de 32 bits, no es necesario liberar los recursos cargados mediante LoadResource. Para las versiones modernas de Windows, esta función siempre devuelve FALSE.

Disminuye (disminuye en uno) el recuento de referencias de un recurso cargado. Cuando el recuento de referencias alcanza cero, se libera la memoria ocupada por el recurso.

Sintaxis

BOOL FreeResource(
  [in] HGLOBAL hResData
);

Parámetros

[in] hResData

Tipo: HGLOBAL

Identificador del recurso. Se supone que LoadResource creó hglbResource.

Valor devuelto

Tipo: BOOL

Si la función es correcta, el valor devuelto es cero.

Si se produce un error en la función, el valor devuelto es distinto de cero, lo que indica que el recurso no se ha liberado.

Comentarios

Para los recursos cargados con otras funciones, FreeResource se ha reemplazado por las siguientes funciones:

Tipo de recurso	Reemplazo de FreeResource
Acelerador	DestroyAcceleratorTable
Bitmap	DeleteObject
Cursor	DestroyCursor
Icono	Destroyicon
Menú	DestroyMenu

El recuento de referencias de un recurso se incrementa (aumenta en uno) cada vez que una aplicación llama a la función LoadResource para el recurso.

El sistema elimina automáticamente estos recursos cuando finaliza el proceso que los creó. Sin embargo, al llamar a la función adecuada, se ahorra memoria. Para más información, consulte LoadResource.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	libloaderapi.h (incluya Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll