|
Previous: utility.library/AddNamedObject |
TOC: Table of Contents |
Index: All Documents |
Next: utility.library/AllocNamedObjectA |
| Title: |
| AllocateTagItems -- allocate a tag list. (V36) |
| Synopsis: |
| tagList = AllocateTagItems(numTags); 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. |
| Parameters: |
| numTags - the number of TagItem slots you want to allocate. |
| Results: |
| 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(). |
| Related topics: |
| <utility/tagitem.h>, FreeTagItems(), CloneTagItems() |