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 |