LocalFlags-Funktion (winbase.h)
Ruft Informationen zum angegebenen lokalen Speicherobjekt ab.
Syntax
UINT LocalFlags(
[in] HLOCAL hMem
);
Parameter
[in] hMem
Ein Handle für das lokale Speicherobjekt. Dieses Handle wird entweder von der Funktion LocalAlloc oder LocalReAlloc 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 LMEM_INVALID_HANDLE, was angibt, dass das lokale Handle ungültig ist. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Das Byte mit niedriger Ordnung des Worts mit niedriger Reihenfolge des Rückgabewerts enthält die Sperranzahl des -Objekts. Um die Sperranzahl aus dem Rückgabewert abzurufen, verwenden Sie die LMEM_LOCKCOUNT-Maske mit dem bitweisen OPERATOR AND (&). Die Sperranzahl von Speicherobjekten, die LMEM_FIXED zugeordnet sind, ist immer 0.
Das hochgeordnete Byte des Worts mit niedriger Reihenfolge des Rückgabewerts gibt die Zuordnungswerte des Speicherobjekts an. Es kann null oder LMEM_DISCARDABLE sein.
Die lokalen Funktionen weisen einen größeren Mehraufwand auf und bieten weniger Features als andere Speicherverwaltungsfunktionen. Neue Anwendungen sollten die Heapfunktionen verwenden, es sei denn, die Dokumentation besagt, dass eine lokale 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 (einschließlich Windows.h) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |