Ring1_Memory_reallocate
Reallocate a memory block.
Ring1_Result
Ring1_Memory_reallocate
(
void **result,
void *p,
size_t n
)
This function reallocates a memory block of to n
Bytes.
In particular, this function fails if p
is a null pointer.
If this function fails, then the existing memory block is not modified.
Parameter variables
result
- A pointer to a pointer a
void *
variable. p
- A pointer to a pointer to a memory block.
n
- The size, in Bytes, to reallocate the memory block to.
Return Values
Ring1_Result_Success
on success, Ring1_Result_Failure
on failure.
Post Conditions
If this function fails, then it sets the by-thread status variable.
Below is a list of failure conditions and the status codes indicating them.
Ring1_Status_InvalidArgument
result
isNULL
Ring1_Status_InvalidArgument
p
isNULL
Ring1_Status_AllocationFailed
- the allocation failed
If this function fails, result
is not dereferenced.
If this function succeeds, *result
is assigned a pointer to the reallocated memory block
of n
Bytes.