HeapAlloc PROC
(MS-Windows)
Allocates a block of memory from a heap that has
already been created by a call to HeapCreate.
If the function succeeds, the return value is a
pointer to the allocated memory block.
If the function fails and you have not specified
HEAP_GENERATE_EXCEPTIONS, the return value is
NULL.
HeapAlloc PROTO, hHeap:DWORD, ; handle to private heap block dwFlags:DWORD, ; heap allocation control flags dwBytes:DWORD ; number of bytes to allocate Returns: (LPVOID) EAX = A pointer to the allocated heap, If failure, NULL, STATUS_NO_MEMORY, or STATUS_ACCESS_VIOLATION |
Argument | Win Type | MASM Type | Description |
---|---|---|---|
hHeap | HANDLE | DWORD | Specifies the heap from which the memory will be allocated. |
dwFlags | DWORD | DWORD | Heap allocation control flags - specifying any one of
these flags will override the corresponding flag specified when the
heap was created with HeapCreate. · HEAP_GENERATE_EXCEPTIONS - raise an exception, don't return NULL. · HEAP_NO_SERIALIZE - mutual exclusion will not be used when accessing the heap. · HEAP_ZERO_MEMORY - the allocated memory will be initialized to zero. |
dwBytes | DWORD | DWORD | The number of bytes to be allocated. |
Converted from CHM to HTML with chm2web Pro 2.85 (unicode) |