NewHandle
Handle NewHandle (size_t numberOfBytes);
Purpose
This function returns a handle to a newly allocated block of memory of the requested size. The contents of the memory block will be all zeros.
Call DisposeHandle to free the memory block.
The handle is a pointer to a second pointer. It is this second pointer which points to the allocated memory block. This method allows the memory block to be resized (by calling SetHandleSize) without changing the value of the handle.
Parameters
| Input | ||
| Name | Type | Description |
| numberOfBytes | size_t | The size of the memory block to allocate |
Return Value
| Name | Type | Description |
| memBlockHandle | Handle | The handle to the memory block. Zero (0) will be returned if there is not enough memory to allocate the block. |
Additional Information
Library: Programmer's Toolbox
Include file: toolbox\toolbox.h
LabWindows/CVI compatibility: LabWindows/CVI 4.0 and later