Condividi tramite


Funzione LocalSize (winbase.h)

Recupera le dimensioni correnti dell'oggetto memoria locale specificato, in byte.

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

SIZE_T LocalSize(
  [in] HLOCAL hMem
);

Parametri

[in] hMem

Handle per l'oggetto memoria locale. Questo handle viene restituito dalla funzione LocalAlloc, LocalReAlloc o LocalHandle.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è la dimensione dell'oggetto memoria locale specificato, in byte. Se l'handle specificato non è valido o se l'oggetto è stato rimosso, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Le dimensioni di un blocco di memoria possono essere maggiori delle dimensioni richieste quando la memoria è stata allocata.

Per verificare che il blocco di memoria dell'oggetto specificato non sia stato eliminato, chiamare la funzione LocalFlags prima di chiamare LocalSize.

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

LocalFlags

LocalHandle

LocalReAlloc

Funzioni di gestione della memoria