Condividi tramite

Funzione LockResource (libloaderapi.h)

  • Articolo

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

Vedere anche

Informazioni concettuali

Riferimento