Freigeben über


GetProcessHeap-Funktion (heapapi.h)

Ruft ein Handle zum Standardheap des aufrufenden Prozesses ab. Dieses Handle kann dann in nachfolgenden Aufrufen der Heapfunktionen verwendet werden.

Syntax

HANDLE GetProcessHeap();

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für den Heap des aufrufenden Prozesses.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die GetProcessHeap-Funktion ruft ein Handle für den Standardheap für den aufrufenden Prozess ab. Ein Prozess kann dieses Handle verwenden, um Arbeitsspeicher aus dem Prozessheap zuzuweisen, ohne zuerst einen privaten Heap mit der HeapCreate-Funktion erstellen zu müssen.

Windows Server 2003 und Windows XP: Um den Heap mit geringer Fragmentierung für den Standardheap des Prozesses zu aktivieren, rufen Sie die HeapSetInformation-Funktion mit dem von GetProcessHeap zurückgegebenen Handle auf.

Beispiele

Ein Beispiel finden Sie unter Abrufen von Prozessheaps.

Anforderungen

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

Siehe auch

Heapfunktionen

HeapCreate

Speicherverwaltungsfunktionen

In VBS-Enclaves verfügbare Vertdll-APIs