[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


   NAME
	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.

   INPUTS
	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().

   SEE ALSO
	<utility/tagitem.h>, FreeTagItems(), CloneTagItems()