Allocates memory on a resource tag.
#include <netware.h>
void *Alloc (
size_t size,
rtag_t rTag);
(IN) Specifies, in bytes, the size of the memory block.
(IN) Specifies the resource tag.
If successful, returns a pointer to the newly allocated memory. Otherwise, returns NULL.
The NetWare operating system counts the allocated memory that each NLM uses. To have it count the memory for a particular component of your NLM, you allocate a resource tag by calling AllocateResourceTag and then call the Alloc function.
If memory is available, the Alloc function returns successfully with a pointer to a piece of memory at least as large as the requested size.
If memory is not immediately available, Alloc returns unsuccessful; it does not sleep.
You must use the Free function to return memory allocated with the Alloc function.