PK_MEMORY_alloc

PK_ERROR_code_t PK_MEMORY_alloc
(
--- received arguments ---
size_t          nbytes,            --- number of bytes required

--- returned arguments ---
void    **const pointer            --- allocated memory (possibly NULL)
)


This function allocates the specified amount of memory required in bytes.


If the requested allocation cannot be met, the NULL pointer is returned.

If the application has registered an allocator function, this will be used
to allocate the memory. If there is a registered thread-specific allocator
function, this will be used in preference to a registered session-wide
allocate function.

The application supplied error handler will not be called if there is a
problem, despite an error code being returned for the function value.

If zero bytes are requested, the function return value will be
PK_ERROR_zero_bytes_required. If the requested allocation cannot be met,
the function return value will be PK_ERROR_memory_full.