GlobalFlags-Funktion (winbase.h)

Ruft Informationen zum angegebenen globalen Speicherobjekt ab.

Hinweis Diese Funktion wird nur aus Gründen der Kompatibilität mit 16-Bit-Versionen von Windows bereitgestellt. Neue Anwendungen sollten die Heapfunktionen verwenden. Weitere Informationen finden Sie in den Hinweisen.

 

Syntax

UINT GlobalFlags(
  [in] HGLOBAL hMem
);

Parameter

[in] hMem

Ein Handle für das globale Speicherobjekt. Dieses Handle wird entweder von der Funktion GlobalAlloc oder GlobalReAlloc zurückgegeben.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt der Rückgabewert die Zuordnungswerte und die Sperranzahl für das Speicherobjekt an.

Wenn die Funktion fehlschlägt, wird der Rückgabewert GMEM_INVALID_HANDLE, was angibt, dass das globale Handle ungültig ist. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Das Byte mit niedriger Ordnung des Worts mit niedriger Ordnung des Rückgabewerts enthält die Sperranzahl des Objekts. Um die Sperranzahl aus dem Rückgabewert abzurufen, verwenden Sie die GMEM_LOCKCOUNT-Maske mit dem bitweisen AND-Operator (&). Die Sperranzahl von Speicherobjekten, die GMEM_FIXED zugeordnet sind, ist immer null.

Das Byte mit hoher Ordnung des Worts in niedriger Reihenfolge des Rückgabewerts gibt die Zuordnungswerte des Speicherobjekts an. Es kann null oder GMEM_DISCARDED sein.

Die globalen Funktionen weisen einen höheren Mehraufwand auf und bieten weniger Features als andere Speicherverwaltungsfunktionen. Neue Anwendungen sollten die Heapfunktionen verwenden, es sei denn, die Dokumentation besagt, dass eine globale Funktion verwendet werden soll. Weitere Informationen finden Sie unter Globale und lokale Funktionen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (Windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

Globale und lokale Funktionen

Globalalloc

GlobalDiscard

GlobalReAlloc

Speicherverwaltungsfunktionen