This procedure finds an item of the specified type whose tag arguments match those pointed to by the tp argument. If more than one item of the specified type has matching tag arguments, the procedure returns the item number for the first matching item. When an item is found, it is automatically opened and prepared for use.
Arguments
cType
Specifies the type of the item to find. Use MkNodeID() to create this value.
tp
A pointer to an array of tag arguments. The tag arguments can be in any order. The array can contain some, all, or none of the possible tag arguments for an item of the specified type; to make the search more specific, include more tag arguments. The last element of the array must be the value TAG_END. If there are no tag arguments, this argument must be NULL. For a list of tag arguments for each item type, see the Portfolio Item's chapter.
Return Value
The procedure returns the number of the first item that matches or an error code if it can't find the item or if an error occurs.The returned item is already opened, so there is no need to call OpenItem() on it. You should call CloseItem() on the supplied item when you are done with it.