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_InvalidArgumentresultisNULLRing1_Status_InvalidArgumentpisNULLRing1_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.