Funzione LockResource (libloaderapi.h)
Recupera un puntatore alla risorsa specificata in memoria.
Sintassi
LPVOID LockResource(
[in] HGLOBAL hResData
);
Parametri
[in] hResData
Tipo: HGLOBAL
Handle alla risorsa a cui accedere. La funzione LoadResource restituisce questo handle. Si noti che questo parametro è elencato come variabile HGLOBAL solo per la compatibilità con le versioni precedenti. Non passare alcun valore come parametro diverso da un valore restituito riuscito dalla funzione LoadResource .
Valore restituito
Tipo: LPVOID
Se la risorsa caricata è disponibile, il valore restituito è un puntatore al primo byte della risorsa; in caso contrario, è NULL.
Commenti
Il puntatore restituito da LockResource è valido fino a quando il modulo contenente la risorsa non viene scaricato. Non è necessario sbloccare le risorse perché il sistema li elimina automaticamente quando il processo che li ha creati termina.
Non provare a bloccare una risorsa usando l'handle restituito dalla funzione FindResourceA o dalla funzione funzione FindResourceExA. Tale handle punta ai dati casuali.
Nota
LockResource non blocca effettivamente la memoria; viene usato solo per ottenere un puntatore alla memoria contenente i dati della risorsa. Il nome della funzione deriva dalle versioni precedenti a Windows XP, quando è stato usato per bloccare un blocco di memoria globale allocato da LoadResource.
Esempio
Per un esempio, vedere Aggiornamento delle risorse.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | libloaderapi.h (includere Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |