Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 est NULL, le système charge la ressource à partir du module utilisé pour créer le processus actuel.
[in] hResInfo
Type : HRSRC
Handle vers 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’erreur étendues, appelez GetLastError.
Remarques
Le type de retour de LoadResource est HGLOBAL pour la compatibilité descendante, et non 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 immédiatement une ressource, une application doit utiliser les fonctions spécifiques aux ressources suivantes pour rechercher et charger la ressource dans un appel.
| Fonction | Action | Pour supprimer la 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érateurs | DestroyAcceleratorTable |
| LoadBitmap | Charge une ressource bitmap | DeleteObject |
| LoadCursor | Charge une ressource de curseur | DestroyCursor |
| LoadIcon | Charge une ressource d’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 pour l’affichage sur l’écran, suivie de DestroyIcon lorsque vous avez terminé.
Exemples
Pour obtenir un exemple, consultez Mise à jour des ressources.
Spécifications
| Besoin | Valeur |
|---|---|
| Client minimum requis | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Fenêtres |
| En-tête | libloaderapi.h (include Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |