Condividi tramite


Funzione LocalFlags (winbase.h)

Recupera informazioni sull'oggetto memoria locale specificato.

Nota Questa funzione viene fornita solo per la compatibilità con le versioni a 16 bit di Windows. Le nuove applicazioni devono usare le funzioni heap. Per altre informazioni, vedere la sezione Osservazioni.
 

Sintassi

UINT LocalFlags(
  [in] HLOCAL hMem
);

Parametri

[in] hMem

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

Valore restituito

Se la funzione ha esito positivo, il valore restituito specifica i valori di allocazione e il conteggio dei blocchi per l'oggetto memoria.

Se la funzione ha esito negativo, il valore restituito viene LMEM_INVALID_HANDLE, a indicare che l'handle locale non è valido. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Il byte in ordine basso della parola di ordine basso del valore restituito contiene il conteggio dei blocchi dell'oggetto. Per recuperare il numero di blocchi dal valore restituito, usare la maschera LMEM_LOCKCOUNT con l'operatore AND bit per bit (&). Il numero di blocchi degli oggetti memoria allocati con LMEM_FIXED è sempre zero.

Il byte di ordine elevato della parola in ordine basso del valore restituito indica i valori di allocazione dell'oggetto memoria. Può essere zero o LMEM_DISCARDABLE.

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

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

GlobalFlags

LocalAlloc

LocalDiscard

LocalLock

LocalReAlloc

LocalUnlock

Funzioni di gestione della memoria