Funzione GlobalFlags (winbase.h)
Recupera informazioni sull'oggetto memoria globale specificato.
Sintassi
UINT GlobalFlags(
[in] HGLOBAL hMem
);
Parametri
[in] hMem
Handle per l'oggetto memoria globale. Questo handle viene restituito dalla funzione GlobalAlloc o GlobalReAlloc.
Valore restituito
Se la funzione ha esito positivo, il valore restituito specifica i valori di allocazione e il conteggio dei blocchi per l'oggetto memory.
Se la funzione ha esito negativo, il valore restituito è GMEM_INVALID_HANDLE, che indica che l'handle globale non è valido. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Il byte a basso ordine della parola a basso ordine del valore restituito contiene il conteggio dei blocchi dell'oggetto. Per recuperare il conteggio dei blocchi dal valore restituito, usare la maschera GMEM_LOCKCOUNT con l'operatore AND bit per bit ( & ). Il numero di blocchi degli oggetti di memoria allocati con GMEM_FIXED è sempre zero.
Il byte ad ordine elevato della parola a basso ordine del valore restituito indica i valori di allocazione dell'oggetto memoria. Può essere zero o GMEM_DISCARDED.
Le funzioni globali 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 usata una documentazione che indica che deve essere usata una funzione globale. 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 |