FreeResource, fonction (libloaderapi.h)

Article
03/01/2024

Notes

Cette fonction est obsolète et n’est prise en charge que pour la compatibilité descendante avec Windows 16 bits. Pour les applications Windows 32 bits, il n’est pas nécessaire de libérer les ressources chargées à l’aide de LoadResource. Pour les versions modernes de Windows, cette fonction retourne toujours FALSE.

Décrémente (diminue d’un) le nombre de références d’une ressource chargée. Lorsque le nombre de références atteint zéro, la mémoire occupée par la ressource est libérée.

Syntaxe

BOOL FreeResource(
  [in] HGLOBAL hResData
);

Paramètres

[in] hResData

Type : HGLOBAL

Handle de la ressource. Il est supposé que hglbResource a été créé par LoadResource.

Valeur retournée

Type : BOOL

Si la fonction aboutit, la valeur de retour est égale à zéro.

Si la fonction échoue, la valeur de retour est différente de zéro, ce qui indique que la ressource n’a pas été libérée.

Remarques

Pour les ressources chargées avec d’autres fonctions, FreeResource a été remplacé par les fonctions suivantes :

Type de ressource	Remplacement de FreeResource
Accélérateur	DestroyAcceleratorTable
Bitmap	DeleteObject
Curseur	DestroyCursor
Icône	DestroyIcon
Menu	DestroyMenu

Le nombre de références pour une ressource est incrémenté (augmenté d’un) chaque fois qu’une application appelle la fonction LoadResource pour la ressource.

Le système supprime automatiquement ces ressources lorsque le processus qui les a créées s’arrête. Toutefois, l’appel de la fonction appropriée permet d’économiser de la mémoire. Pour plus d’informations, consultez LoadResource.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	libloaderapi.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll