Funzione GlobalFlags (winbase.h)

  • Articolo

Recupera informazioni sull'oggetto memoria globale 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 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

Vedere anche

Funzioni globali e locali

Globalalloc

GlobalDiscard

GlobalReAlloc

Funzioni di gestione della memoria