GetProcessHeap function (heapapi.h)
Retrieves a handle to the default heap of the calling process. This handle can then be used in subsequent calls to the heap functions.
HANDLE GetProcessHeap();
If the function succeeds, the return value is a handle to the calling process's heap.
If the function fails, the return value is NULL. To get extended error information, call GetLastError.
The GetProcessHeap function obtains a handle to the default heap for the calling process. A process can use this handle to allocate memory from the process heap without having to first create a private heap using the HeapCreate function.
Windows Server 2003 and Windows XP: To enable the low-fragmentation heap for the default heap of the process, call the HeapSetInformation function with the handle returned by GetProcessHeap.
For an example, see Getting Process Heaps.
Requirement | Value |
---|---|
Minimum supported client | Windows XP [desktop apps | UWP apps] |
Minimum supported server | Windows Server 2003 [desktop apps | UWP apps] |
Target Platform | Windows |
Header | heapapi.h (include Windows.h) |
Library | Kernel32.lib |
DLL | Kernel32.dll |