Funzione LocalHandle (winbase.h)

Recupera l'handle associato al puntatore specificato in un oggetto memoria locale.

Nota Le funzioni locali hanno un sovraccarico maggiore e forniscono meno funzionalità rispetto ad altre funzioni di gestione della memoria. Le nuove applicazioni devono usare le funzioni heap , a meno che non venga utilizzata una documentazione che indica che deve essere usata una funzione locale. Per altre informazioni, vedere Funzioni globali e locali.

 

Sintassi

HLOCAL LocalHandle(
  [in] LPCVOID pMem
);

Parametri

[in] pMem

Puntatore al primo byte dell'oggetto memoria locale. Questo puntatore viene restituito dalla funzione LocalLock .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per l'oggetto memoria locale specificato.

Se la funzione ha esito negativo, il valore restituito è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Quando la funzione LocalAlloc alloca un oggetto memoria locale con LMEM_MOVEABLE, restituisce un handle all'oggetto. La funzione LocalLock converte questo handle in un puntatore al blocco di memoria dell'oggetto e LocalHandle converte nuovamente il puntatore in un handle.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

Funzioni globali e locali

LocalAlloc

LocalLock

Funzioni di gestione della memoria