HeapCreate PROC   (MS-Windows)

   Creates a private heap object that can be used by the calling process by invoking HeapAlloc.
   It reserves space in the virtual address space of the process and allocates physical storage for a specified initial portion of this block.
   Used by HeapAlloc, HeapFree, HeapReAllocate, and HeapSize.
   If the function succeeds, it returns a handle to the new heap in EAX.
   If it fails, the return value is NULL (invoke GetLastError to get extended error information).


HeapCreate PROTO,
    flOptions:DWORD,     ; heap allocation options
    dwInitialSize:DWORD, ; initial heap size, in bytes
    dwMaximumSize:DWORD  ; maximum heap size, in bytes

Returns: (HANDLE) EAX = Handle to the newly created heap, or
                        NULL if failure.

Argument Win Type MASM Type Description
flOptions DWORD DWORD  Specifies optional attributes for the new heap.
· HEAP_GENERATE_EXCEPTIONS - raise an exception, don't return NULL.
· HEAP_NO_SERIALIZE - mutual exclusion will not be used when accessing the heap.
dwInitialSize DWORD DWORD  The initial size of the heap in bytes rounded up to the next page boundary.
dwMaximumSize DWORD DWORD · If zero, the heap is growable.
· If non-zero, specifies the maximum heap size in bytes rounded up to the next page boundary.
 Use GetSystemInfo to determine the size of a page.

Converted from CHM to HTML with chm2web Pro 2.85 (unicode)