Partager via


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

Voir aussi

Conceptuel

Référence