# NewHandle

Handle NewHandle (unsigned int 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 | unsigned integer | 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.