LoadResource, fonction (libloaderapi.h)

Article
02/28/2024

Récupère un handle qui peut être utilisé pour obtenir un pointeur vers le premier octet de la ressource spécifiée en mémoire.

Syntaxe

HGLOBAL LoadResource(
  [in, optional] HMODULE hModule,
  [in]           HRSRC   hResInfo
);

Paramètres

[in, optional] hModule

Type : HMODULE

Handle du module dont le fichier exécutable contient la ressource. Si hModule a la valeur NULL, le système charge la ressource à partir du module utilisé pour créer le processus actuel.

[in] hResInfo

Type : HRSRC

Handle de la ressource à charger. Ce handle est retourné par la fonction FindResource ou FindResourceEx .

Valeur retournée

Type : HGLOBAL

Si la fonction réussit, la valeur de retour est un handle pour les données associées à la ressource.

Si la fonction échoue, la valeur de retour est NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Le type de retour de LoadResource est HGLOBAL pour la compatibilité descendante, pas parce que la fonction retourne un handle à un bloc de mémoire global. Ne passez pas ce handle à la fonction GlobalLock ou GlobalFree . Pour obtenir un pointeur vers le premier octet des données de ressource, appelez la fonction LockResource ; pour obtenir la taille de la ressource, appelez SizeofResource.

GlobalSize retourne 0 pour une ressource HGLOBAL. Par conséquent, toutes les API qui dépendent de GlobalSize pour déterminer la taille du HGLOBAL ne fonctionneront pas correctement. Par exemple, utilisez SHCreateMemStream au lieu de CreateStreamOnHGlobal.

Pour utiliser une ressource immédiatement, une application doit utiliser les fonctions spécifiques à la ressource suivantes pour rechercher et charger la ressource en un seul appel.

Fonction	Action	Pour supprimer une ressource
FormatMessage	Charge et met en forme une entrée de table de messages	Aucune action n’est nécessaire
LoadAccelerators	Charge une table d’accélérateur	DestroyAcceleratorTable
LoadBitmap	Charge une ressource bitmap	DeleteObject
LoadCursor	Charge une ressource de curseur	DestroyCursor
LoadIcon	Charge une ressource icône	DestroyIcon
LoadMenu	Charge une ressource de menu	DestroyMenu
LoadString	Charge une ressource de chaîne	Aucune action n’est nécessaire

Par exemple, une application peut utiliser la fonction LoadIcon pour charger une icône à afficher à l’écran, suivie de DestroyIcon lorsque vous avez terminé.

Exemples

Pour obtenir un exemple, consultez Mise à jour des ressources.

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