Compartir a través de


Función FreeResource (libloaderapi.h)

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

Vea también

DeleteObject

DestroyAcceleratorTable

DestroyCursor

Destroyicon

DestroyMenu

LoadResource

Otros recursos

Referencia