LocalSize-Funktion (winbase.h)

Artikel
03/06/2024

Ruft die aktuelle Größe des angegebenen lokalen Speicherobjekts in Bytes ab.

Hinweis Die lokalen 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 lokale Funktion verwendet werden soll. Weitere Informationen finden Sie unter Globale und lokale Funktionen.

Syntax

SIZE_T LocalSize(
  [in] HLOCAL hMem
);

Parameter

[in] hMem

Ein Handle für das lokale Speicherobjekt. Dieses Handle wird von der Funktion LocalAlloc, LocalReAlloc oder LocalHandle zurückgegeben.

Rückgabewert

Wenn die Funktion erfolgreich ist, entspricht der Rückgabewert der Größe des angegebenen lokalen Speicherobjekts in Byte. Wenn das angegebene Handle ungültig ist oder das Objekt verworfen wurde, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die Größe eines Speicherblocks kann größer sein als die größe, die beim Zuweisen des Arbeitsspeichers angefordert wurde.

Um zu überprüfen, ob der Arbeitsspeicherblock des angegebenen Objekts nicht verworfen wurde, rufen Sie die LocalFlags-Funktion auf, bevor Sie LocalSize aufrufen.

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