GlobalSize-Funktion (winbase.h)

  • Artikel

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

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

Syntax

SIZE_T GlobalSize(
  [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, ist der Rückgabewert die Größe des angegebenen globalen Speicherobjekts in Bytes.

Wenn das angegebene Handle ungültig ist oder das Objekt verworfen wurde, ist der Rückgabewert 0. 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 Speicherblock des angegebenen Objekts nicht verworfen wurde, verwenden Sie die GlobalFlags-Funktion , bevor Sie GlobalSize aufrufen.

Anforderungen

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

Siehe auch

Globale und lokale Funktionen

Globalalloc

GlobalFlags

GlobalReAlloc

Speicherverwaltungsfunktionen