|
CoTaskMemRealloc
Changes the size of a previously allocated block of task memory.
LPVOID CoTaskMemRealloc(
LPVOID pv,
| //Points to memory block to be reallocated
| ULONG cb
| //Size in bytes of block to be reallocated
| );
|
|
Parameters
pv
Points to the memory block to be reallocated. It can be a NULL pointer, as
discussed in the Comments.
cb
Specifies the size in bytes of the memory block to be reallocated. It can be
zero, as discussed in the following remarks.
Return Values
Reallocated memory block
Indicates memory block successfully reallocated.
NULL
Indicates insufficient memory or cb is zero and pv is not NULL.
Comments
The CoTaskMemRealloc 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.
The pv 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.
The cb 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 is freed.
CoTaskMemRealloc 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
than void, use a type cast on the return value.
See Also
CoTaskMemAlloc, CoTaskMemFree, CoGetMalloc, IMalloc::Realloc
| Last news from Greatis Software |
 |
|
Nostalgia .Net |
|
.Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More » |
| Recommended software for developers |
 |
|
Ultimate Pack |
|
Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More » |
 |
|
Form Designer .Net |
|
Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More » |
 |
|
Print Suite .Net |
|
Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More » |
 |
|
Gradient Controls .Net |
|
Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More » |
 |
|
Greatis iGrid |
|
iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More » |
All the contacts and projectsDmitry Vasiliev (just.dmitry)
Related LinksSoftware for Visual Studio .NET developers Software for Delphi and C++ Builder developers Software for Visual Basic 6 developers Delphi Tips&Tricks MegaDetailed.NET More Online Helps Win32 Programmer's Reference Win32 Multimedia Programmer's Reference OLE Programmer's Reference Microsoft Windows Pen API Programmer's Reference Microsoft Windows Sockets 2 Reference Microsoft Windows Telephony API (TAPI) Programmer's Reference Unix Manual Pages
|