Changes the size of a previously allocated block of task memory.
| LPVOID pv,
||//Points to memory block to be reallocated
| ULONG cb
||//Size in bytes of block to be reallocated
Points to the memory block to be reallocated. It can be a NULL pointer, as
discussed in the Comments.
Specifies the size in bytes of the memory block to be reallocated. It can be
zero, as discussed in the following remarks.
Reallocated memory block
Indicates memory block successfully reallocated.
Indicates insufficient memory or cb
is zero and pv
is not NULL.
function changes the size of a previously allocated memory block in the same
way that IMalloc::Realloc
does. It is not necessary to call the CoGetMalloc
function to get a pointer to the OLE allocator before calling CoTaskMemRealloc
argument points to the beginning of the memory block. If pv
is NULL, CoTaskMemRealloc
allocates a new memory block in the same way as the CoTaskMemAlloc
function. If pv
is not NULL, it should be a pointer returned by a prior call to CoTaskMemAlloc
argument specifies the size (in bytes) of the new block. The contents of the
block are unchanged up to the shorter of the new and old sizes, although the
new block can be in a different location. Because the new block can be in a
different memory location, the pointer returned by CoTaskMemRealloc
is not guaranteed to be the pointer passed through the pv
argument. If pv
is not NULL and cb
is zero, then the memory pointed to by pv
returns a void pointer to the reallocated (and possibly moved) memory block.
The return value is NULL if the size is zero and the buffer argument is not
NULL, or if there is not enough memory available to expand the block to the given
size. In the first case, the original block is freed; in the second, the
original block is unchanged.
The storage space pointed to by the return value is guaranteed to be suitably
aligned for storage of any type of object. To get a pointer to a type other
, use a type cast on the return value.
CoTaskMemAlloc, CoTaskMemFree, CoGetMalloc, IMalloc::Realloc
- Software for developers
Software for Android Developers
- More information resources
Unix Manual Pages