Home / Autodocs / utility.library
NAME
- AllocateTagItems
-
allocate a tag list. (V36)
SYNOPSIS
tagList = AllocateTagItems(numTags);
D0 D0
struct TagItem *AllocateTagItems(ULONG);
D0 D0
struct TagItem *AllocateTagItems(ULONG);
FUNCTION
Allocates the specified number of usable TagItems slots.
Note that to access the TagItems in 'tagList', you should use the function NextTagItem(). This will insure you respect any chaining (TAG_MORE) and secret hiding places (TAG_IGNORE) that this function might generate.
Note that to access the TagItems in 'tagList', you should use the function NextTagItem(). This will insure you respect any chaining (TAG_MORE) and secret hiding places (TAG_IGNORE) that this function might generate.
INPUTS
- numTags
-
the number of TagItem slots you want to allocate.
RESULT
- tagList
-
the allocated chain of TagItem structures, or NULL if there was not enough memory. An allocated tag list must eventually be freed using FreeTagItems().