LockResource, fonction (libloaderapi.h)
Récupère un pointeur vers la ressource spécifiée en mémoire.
Syntaxe
LPVOID LockResource(
[in] HGLOBAL hResData
);
Paramètres
[in] hResData
Type : HGLOBAL
Handle de la ressource à accéder. La fonction LoadResource retourne ce handle. Notez que ce paramètre est répertorié en tant que variable HGLOBAL uniquement pour la compatibilité descendante. Ne transmettez aucune valeur en tant que paramètre autre qu’une valeur de retour réussie à partir de la fonction LoadResource .
Valeur retournée
Type : LPVOID
Si la ressource chargée est disponible, la valeur de retour est un pointeur vers le premier octet de la ressource ; sinon, elle est NULL.
Notes
Le pointeur retourné par LockResource est valide jusqu’à ce que le module contenant la ressource soit déchargé. Il n’est pas nécessaire de déverrouiller des ressources, car le système les supprime automatiquement lorsque le processus qui les a créées s’arrête.
N’essayez pas de verrouiller une ressource à l’aide du handle retourné par la fonction FindResourceA ou la fonction FindResourceExA . Un tel handle pointe vers des données aléatoires.
Notes
LockResource ne verrouille pas réellement la mémoire ; il est simplement utilisé pour obtenir un pointeur vers la mémoire contenant les données de ressource. Le nom de la fonction provient de versions antérieures à Windows XP, lorsqu’elle était utilisée pour verrouiller un bloc de mémoire global alloué par LoadResource.
Exemples
Pour obtenir un exemple, consultez Mise à jour des ressources.
Spécifications
| 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 |