NAME
AllocateTagItems -- Allocate a tagitem array (or chain). (v36)
SYNOPSIS
tagList = AllocateTagItems( numItems )
D0 D0
struct tagitem *allocatetagitems( ulong numitems);
FUNCTION
Allocates the specified number of usable TagItems slots, and does
so in a format that the function freetagitems can handle.
Note that to access the TagItems in 'tagList', you should use
the function nexttagitem(). this will insure you respect any
chaining (TAG_MORE) that the list uses, and will skip any
TAG_IGNORE items that AllocateTagItems() might use to stash
size and other information.
INPUTS
numItems - the number of tagitem slots you want to allocate.
RESULT
tagList - the allocated chain of tagitem structures. will
return NULL if unsuccessful.
BUGS
SEE ALSO
freetagitems(), clonetagitems()