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 |