|
CoTaskMemAlloc
Allocates a block of task memory in the same way that IMalloc::Alloc does.
LPVOID CoTaskMemAlloc(
ULONG cb
| //Size in bytes of memory block to be allocated
| );
|
|
Parameter
cb
Specifies the size (in bytes) of the memory block to be allocated.
Return Values
Allocated memory block
Indicates memory block allocated successfully.
NULL
Indicates insufficient memory available.
Comments
The CoTaskMemAlloc function uses the default allocator to allocate a memory block in the same
way that IMalloc::Alloc does. It is not necessary to call the CoGetMalloc function before calling CoTaskMemAlloc.
The initial contents of the returned memory block are undefined  there is no guarantee that the block has been initialized. The allocated block
may be larger than cb bytes because of the space required for alignment and for maintenance
information.
If cb is zero, CoTaskMemAlloc allocates a zero-length item and returns a valid pointer to that item. If
there is insufficient memory available, CoTaskMemAlloc returns NULL.
Note Applications should always check the return value from this method, even
when requesting small amounts of memory, because there is no guarantee the memory
will be allocated.
See Also
IMalloc::Alloc, CoGetMalloc, CoTaskMemFree, CoTaskMemRealloc
Related LinksSoftware for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (sock2.hlp)
Unix Manual Pages
|
