int SetHandleSize (Handle handle, unsigned int newSize);
This function changes the size of the memory block refered to by a handle. If the new block is larger than the current block then all of the current data in the block is preserved and the new portion of the block is filled with zeros. If the new block is smaller than the current block then as much of the data in the current block that can fit in the new block is preserved and the rest of the data is discarded.
Input | ||
Name | Type | Description |
handle | Handle | The handle whose memory block size will be changed. |
newSize | unsigned integer | The new size (in bytes) for the memory block referred to by the handle. |
Name | Type | Description |
result | integer | Returns 1 (TRUE) if the size was set. Returns 0 (FALSE) if the there was not enough memory to change the size. |